· 9 years ago · May 28, 2017, 12:50 AM
1# __________________________________________________________
2
3# / / / /\ \
4
5# \_\___________________________________________________\_\/ /
6
7# / / _____ __ __ / /
8
9# / / / ____\ / / /_/ /\ / /
10
11# / / / /__ / /___ ___ __ ______ __/ /_ / /
12
13# / / \___ \ / __/ / __\ / / / __ //_ __/ / /
14
15# / / ____/ / / /\ \ / / / / / /_/ / / / / /
16
17# / / \_____/ /_/ /_/ /_/ /_/ / ____/ /_/ / /__
18
19# / / ========================== / / ========== / / \ \
20
21# | | /_/ | | | |
22
23# \_\_________________________________________________\_\_/_/
24
25#
26
27# == Introduction ==
28
29# This file contains Skript's general options. To write scripts, create a new .sk file in the scripts folder or edit any existing one.
30
31#
32
33# Script files prefixed with a hyphen (-) will not be loaded, e.g. renaming 'plant with hoe.sk' to '-plant with hoe.sk' will disable the whole file.
34
35# This can e.g. be used to temporarily disable scripts and is also used for Skript's example scripts.
36
37# You can also use the command '/skript enable/disable <script>' to enable/disable a script which will automatically rename it.
38
39#
40
41# === !!! PLEASE NOTE !!! ===
42
43# This file, all scripts and other files ending in .sk are NOT .yml/YAML files, but very similar!
44
45# Please remember the following when editing files:
46
47# - To indent sections you can use spaces like in YAML, but tabs are also allowed. Just remember to stick to the one or the other for a section/trigger.
48
49# - '#' starts a comment like in YAML. If you don't want it to start a comment simply double it: '##' (You also have to double these in "quoted text")
50
51# - If you use special characters (§, äöü, éèà ôç, ñ, etc.) you have to encode the file in UTF-8.
52
53#
54
55
56
57
58
59
60
61# ==== General Options ====
62
63
64
65language: english
66
67# Which language to use. Currently english and german are included in the download, but custom languages can be created as well.
68
69# Please note that not everything can be translated yet, i.e. parts of Skript will still be english if you use another language.
70
71# If you want to translate Skript to your language please read the readme.txt located in the /lang/ folder in the jar
72
73# (open the jar as zip or rename it to Skript.zip to access it)
74
75
76
77
78
79check for new version: false
80
81# Whether Skript should check for whether a new version of Skript is available when the server starts.
82
83# If this is set to true Skript will announce a new version to all players with the "skript.admin" permission.
84
85# If set to false you can still check for a new version with '/skript update check'.
86
87# Please note that Skript will not detect beta releases even if you are running one as they are not necessarily stable.
88
89
90
91update check interval: 12 hours
92
93# If 'check for new version' is enabled, this sets how often to check for a new update.
94
95# A first check will always be made when the server starts, after that checks will be made in intervals set by this option.
96
97# Set this to 0 to disable repeated checks, in which case only one check will be made when the server starts.
98
99# Please note that this option is currently the only means of making Skript check for an update more than once,
100
101# as '/skript update check' does only display the results of the last check if a check has been made before.
102
103
104
105automatically download new version: false
106
107# Whether Skript should automatically download & install the newest version if one is available.
108
109# I suggest to disable this feature if your server restarts automatically as you likely won't be informed
110
111# of any incompatibilities of your scripts and the newest version of Skript.
112
113# If you disable this you can still use '/skript update download' to make Skript download the newest version.
114
115# If you're concerned about changes use '/skript update changes' for a full list of changes since your current version.
116
117
118
119
120
121enable effect commands: false
122
123effect command token: !
124
125# If 'enable effect commands' is set to true, chat messages starting with the 'effect command token' will be interpreted as effects and executed.
126
127# The token can be longer than a single character, but it should not start with '/' as that starts a command.
128
129# A player needs the permission "skript.effectcommands" to use such commands,
130
131# which does not default to OPs since these commands can do severe damage to the world or crash the server (see below).
132
133# Some example commands which can be used if this setting is enabled:
134
135# !heal player - heals the player (doesn't do anything if used from the console)
136
137# !repair tool - repairs the currently held item
138
139# !broadcast "<red>Please read the rules!" - if you want to get rid of the quotes you have to define a custom command
140
141# !set time to 6:00 - sets the time in the current world
142
143# The command can also be abused, so only give the permission to trusted players, like owners & co-owners:
144
145# !spawn 20 ender dragons - will destroy a large part of the world in a short time if no protection is present
146
147# !create explosion of force 10000 - likely crashes the server or at least hangs it up for a long time
148
149# !ban all players - as the effect implies
150
151
152
153allow ops to use effect commands: false
154
155# Whether server operators which do not have the permission "skript.effectcommands" should have access to effect commands.
156
157# This setting is mainly useful for servers that do not run any permissions plugin.
158
159
160
161
162
163date format: default
164
165# The date format to be used when dates should be displayed.
166
167# This can be 'default' to use Java's default date format for the system's language.
168
169# The format is that of Java's SimpleDateFormat as defined here: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
170
171# some examples:
172
173# d/M/yyyy h:mm a => 15/7/2012 8:53 PM
174
175# dd.MM.yyyy, HH:mm => 16.03.2013, 09:33
176
177
178
179
180
181verbosity: normal
182
183# Determines how much info is logged.
184
185# Allowed values: low, normal, high, very high, debug
186
187# The highest you should go is very high, which prints quite a lot of useful information,
188
189# including how much time each trigger takes to execute.
190
191# Only use debug if you're programming an add-on for Skript, but even then you might usually not need it.
192
193
194
195
196
197plugin priority: high
198
199# Allowed values: lowest, low, normal, high, highest
200
201# Change this if you encounter problems with other plugins, e.g.:
202
203# - cancelled events: The event is cancelled by another plugin, but Skript handles the event nonetheless => increase priority
204
205# (e.g. WorldGuard cancels events if a player doesn't have permission for the given region,
206
207# and you made some 'place' triggers which should not bypass WorldGuard's protection)
208
209# - effects '(un)cancel event': Another plugin should/should not process the event, but does/does not => decrease priority
210
211# - effect 'drop': Another plugin doesn't process added drops => decrease priority
212
213# - effects 'remove ... from drops'/'clear drops': Drops added by other plugins are not removed => increase priority
214
215# Skript removes drops it shouldn't => decrease priority or specify which item types to remove
216
217
218
219
220
221log player commands: true
222
223# Whether Skript should log the usage of custom commands.
224
225# They will be logged as [INFORMATION] in this format: '<player>: /<command> <arguments>'
226
227
228
229
230
231number accuracy: 2
232
233# How many digits should be displayed after the dot at maximum when displaying numbers.
234
235# Zeroes will never be displayed at all, so this setting only applies to numbers that actually have a decimal part with one or more non-zero digits.
236
237
238
239
240
241maximum target block distance: 100
242
243# How far to search for a player's targeted block in blocks/meters.
244
245# Lower values improve performance, but might reduce the usability of your scripts.
246
247# This value is limited by the server (e.g. by 'view-distance' in the server.properties), but is guaranteed to work up to 100 meters.
248
249
250
251
252
253case sensitive: false
254
255# Whether Skript's functions should be case sensitive or not.
256
257# This e.g. applies to the effect 'replace' and the conditions 'contains' and 'is/is not'.
258
259
260
261
262
263disable variable conflict warnings: false
264
265# Disables warnings of potential variable name conflicts if set to true.
266
267# I recommend to not touch this option, but if you do so you should at least set it back to false
268
269# whenever you create new scripts with new variables.
270
271
272
273
274
275
276
277# ==== Variables ====
278
279
280
281databases:
282
283 # Databases to store variables in. These can either be used as a simple one-server-storage
284
285 # where variables are written constantly but only read at server start,
286
287 # or as a connection between multiple servers by monitoring the database(s) for changes.
288
289 #
290
291 # You can define as many databases as you want, just make sure to choose a distinct name for each one, and don't forget to set all options correctly.
292
293 #
294
295 # To be able to use a database you'll need to download the plugin 'SQLibrary' from http://dev.bukkit.org/server-mods/sqlibrary/files/
296
297 # and install it in your server's plugin directory like other plugins.
298
299 #
300
301 # Please note that '/skript reload' will not reload this section, i.e. you'll have to restart Skript for changes to take effect.
302
303
304
305 # Each database definition must be in a separate section. You can choose any name for the sections, as long as it's not already used.
306
307 database 1:
308
309 # an example database to describe all possible options.
310
311
312
313 type: disabled
314
315 # The type of this database. Allowed values are 'CSV', 'SQLite', 'MySQL' and 'disabled'.
316
317 # CSV uses a text file to store the variables, while SQLite and MySQL use databases, and 'disabled' makes Skript ignore the database as if it wasn't defined at all.
318
319
320
321 pattern: .*
322
323 # Defines which variables to save in this database.
324
325 # This pattern uses Regex syntax, e.g. use 'db_.*' (without the quotes) to store all variables prefixed with 'db_' in this database,
326
327 # or use '.*' (the default value) to store all variables here (recommended for the last database in this list, as otherwise some variables might not be saved).
328
329 # Please note that variables are only stored in one database, and databases are checked from top to bottom,
330
331 # e.g. if a variable matches the topmost database's pattern it will be saved there and nowhere else.
332
333 # BTW: Patterns are checked in a separate thread, i.e. your server likely won't run slower when using complicated patterns.
334
335
336
337 monitor changes: false
338
339 monitor interval: 20 seconds
340
341 # If 'monitor changes' is set to true, variables will repeatedly be checked for updates in the database (in intervals set in 'monitor interval').
342
343 # ! Please note that you should set 'pattern', 'monitor changes' and 'monitor interval' to the same values on all servers that access the same database!
344
345
346
347 # == MySQL configuration ==
348
349 host: localhost # Where the database server is located at, e.g. 'example.com', 'localhost', or '192.168.1.100'
350
351 port: 3306 # 3306 is MySQL's default port, i.e. you likely won't need to change this value
352
353 user: root
354
355 password: pass
356
357 database: skript # The database to use. Skript will automatically create a table 'variables21' in this database if it doesn't exist
358
359 # (If the table exists but is defined differently that how Skript expects it to be you'll get errors and no variables will be saved and/or loaded)
360
361
362
363 # == SQLite/CSV configuration ==
364
365 file: ./plugins/Skript/variables.db
366
367 # Where to save the variables to. For a CSV file, the file extension '.csv' is recommended, but not required, but SQLite database files must end in '.db' (SQLibrary forces this).
368
369 # The file path can either be absolute (e.g. 'C:\whatever\...' [Windows] or '/usr/whatever/...' [Unix]), or relative to the server directory (e.g. './plugins/Skript/...').
370
371
372
373 backup interval: 2 hours
374
375 # Creates a backup of the file every so often. This can be useful if you ever want to revert variables to an older state.
376
377 # Variables are saved constantly no matter what is set here, thus a server crash will never make you loose any variables.
378
379 # Set this to 0 to disable this feature.
380
381
382
383
384
385 MySQL example:
386
387 # A MySQL database example, with options unrelated to MySQL removed.
388
389
390
391 type: disabled # change to line below to enable this database
392
393 # type: MySQL
394
395
396
397 pattern: synced_.* # this pattern will save all variables that start with 'synced_' in this MySQL database.
398
399
400
401 host: localhost
402
403 port: 3306
404
405 user: root
406
407 password: pass
408
409 database: skript
410
411
412
413 monitor changes: true
414
415 monitor interval: 20 seconds
416
417
418
419 SQLite example:
420
421 # An SQLite database example.
422
423
424
425 type: disabled # change to line below to enable this database
426
427 # type: SQLite
428
429
430
431 pattern: db_.* # this pattern will save all variables that start with 'db_' in this SQLite database.
432
433
434
435 file: ./plugins/Skript/variables.db
436
437 # SQLite databases must end in '.db'
438
439
440
441 backup interval: 0 # 0 = don't create backups
442
443 monitor changes: false
444
445 monitor interval: 20 seconds
446
447
448
449 default:
450
451 # The default "database" is a simple text file, with each variable on a separate line and the variable's name, type, and value separated by commas.
452
453 # This is the last database in this list to catch all variables that have not been saved anywhere else.
454
455 # You can modify this database freely, but make sure to know what you're doing if you don't want to loose any variables.
456
457
458
459 type: CSV
460
461
462
463 pattern: .*
464
465
466
467 file: ./plugins/Skript/variables.csv
468
469
470
471 backup interval: 2 hours
472
473
474
475 # PS: If you don't want some variables to be saved in any database (e.g. variables that contain an %entity% which usually despawn when the server is shut down)
476
477 # you can modify the last database's pattern to not match all variables, e.g. use '(?!x_).*' to match all variables that don't start with 'x_'.
478
479 # Be very cautious when doing this however as unsaved variables cannot be recovered after the server has been stopped.
480
481 # I recommend to use a single character to denote unsaved variables (similar to local variables' '_'), e.g. '-', in which case the last database's pattern should be '(?!-).*'.
482
483
484
485
486
487
488
489# ==== Settings that should not be changed ====
490
491
492
493version: 2.1.2
494
495# DO NOT CHANGE THIS VALUE MANUALLY!
496
497# This saves for which version of Skript this configuration was written for.
498
499# If it does not match the version of the .jar file then the config will be updated automatically.