· 8 years ago · Feb 01, 2018, 11:10 AM
11 # __________________________________________________________
2
32 # / / / /\ \
4
53 # \_\___________________________________________________\_\/ /
6
74 # / / _____ __ __ / /
8
95 # / / / ____\ / / /_/ /\ / /
10
116 # / / / /__ / /___ ___ __ ______ __/ /_ / /
12
137 # / / \___ \ / __/ / __\ / / / __ //_ __/ / /
14
158 # / / ____/ / / /\ \ / / / / / /_/ / / / / /
16
179 # / / \_____/ /_/ /_/ /_/ /_/ / ____/ /_/ / /__
18
1910 # / / ========================== / / ========== / / \ \
20
2111 # | | /_/ | | | |
22
2312 # \_\_________________________________________________\_\_/_/
24
2513 #
26
2714 # == Introduction ==
28
2915 # 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
3116 #
32
3317 # 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
3518 # This can e.g. be used to temporarily disable scripts and is also used for Skript's example scripts.
36
3719 # You can also use the command '/skript enable/disable <script>' to enable/disable a script which will automatically rename it.
38
3920 #
40
4121 # === !!! PLEASE NOTE !!! ===
42
4322 # This file, all scripts and other files ending in .sk are NOT .yml/YAML files, but very similar!
44
4523 # Please remember the following when editing files:
46
4724 # - 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
4925 # - '#' 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
5126 # - If you use special characters (§, äöü, éèà ôç, ñ, etc.) you have to encode the file in UTF-8.
52
5327 #
54
5528
56
5729
58
5930
60
6131 # ==== General Options ====
62
6332
64
6533 language: english
66
6734 # Which language to use. Currently english and german are included in the download, but custom languages can be created as well.
68
6935 # Please note that not everything can be translated yet, i.e. parts of Skript will still be english if you use another language.
70
7136 # If you want to translate Skript to your language please read the readme.txt located in the /lang/ folder in the jar
72
7337 # (open the jar as zip or rename it to Skript.zip to access it)
74
7538
76
7739
78
7940 check for new version: true
80
8141 # Whether Skript should check for whether a new version of Skript is available when the server starts.
82
8342 # If this is set to true Skript will announce a new version to all players with the "skript.admin" permission.
84
8543 # If set to false you can still check for a new version with '/skript update check'.
86
8744 # Please note that Skript will not detect beta releases even if you are running one as they are not necessarily stable.
88
8945
90
9146 update check interval: 12 hours
92
9347 # If 'check for new version' is enabled, this sets how often to check for a new update.
94
9548 # A first check will always be made when the server starts, after that checks will be made in intervals set by this option.
96
9749 # Set this to 0 to disable repeated checks, in which case only one check will be made when the server starts.
98
9950 # Please note that this option is currently the only means of making Skript check for an update more than once,
100
10151 # as '/skript update check' does only display the results of the last check if a check has been made before.
102
10352
104
10553 automatically download new version: false
106
10754 # Whether Skript should automatically download & install the newest version if one is available.
108
10955 # I suggest to disable this feature if your server restarts automatically as you likely won't be informed
110
11156 # of any incompatibilities of your scripts and the newest version of Skript.
112
11357 # If you disable this you can still use '/skript update download' to make Skript download the newest version.
114
11558 # If you're concerned about changes use '/skript update changes' for a full list of changes since your current version.
116
11759
118
11960
120
12161 enable effect commands: false
122
12362 effect command token: !
124
12563 # If 'enable effect commands' is set to true, chat messages starting with the 'effect command token' will be interpreted as effects and executed.
126
12764 # The token can be longer than a single character, but it should not start with '/' as that starts a command.
128
12965 # A player needs the permission "skript.effectcommands" to use such commands,
130
13166 # which does not default to OPs since these commands can do severe damage to the world or crash the server (see below).
132
13367 # Some example commands which can be used if this setting is enabled:
134
13568 # !heal player - heals the player (doesn't do anything if used from the console)
136
13769 # !repair tool - repairs the currently held item
138
13970 # !broadcast "<red>Please read the rules!" - if you want to get rid of the quotes you have to define a custom command
140
14171 # !set time to 6:00 - sets the time in the current world
142
14372 # The command can also be abused, so only give the permission to trusted players, like owners & co-owners:
144
14573 # !spawn 20 ender dragons - will destroy a large part of the world in a short time if no protection is present
146
14774 # !create explosion of force 10000 - likely crashes the server or at least hangs it up for a long time
148
14975 # !ban all players - as the effect implies
150
15176
152
15377 allow ops to use effect commands: false
154
15578 # Whether server operators which do not have the permission "skript.effectcommands" should have access to effect commands.
156
15779 # This setting is mainly useful for servers that do not run any permissions plugin.
158
15980
160
16181
162
16382 use player UUIDs in variable names: false
164
16583 # Whether to use a player's UUID instead of their name in variables, e.g. {home.%player%} will look like
166
16784 # {home.e5240337-a4a2-39dd-8ed9-e5ce729a8522} instead of {home.njol}.
168
16985 # Please note that if this setting is changed old variables WILL NOT be renamed automatically.
170
17186
172
17387
174
17588 date format: default
176
17789 # The date format to be used when dates should be displayed.
178
17990 # This can be 'default' to use Java's default date format for the system's language.
180
18191 # The format is that of Java's SimpleDateFormat as defined here: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
182
18392 # some examples:
184
18593 # d/M/yyyy h:mm a => 15/7/2012 8:53 PM
186
18794 # dd.MM.yyyy, HH:mm => 16.03.2013, 09:33
188
18995
190
19196
192
19397 verbosity: normal
194
19598 # Determines how much info is logged.
196
19799 # Allowed values: low, normal, high, very high, debug
198
199100 # The highest you should go is very high, which prints quite a lot of useful information,
200
201101 # including how much time each trigger takes to execute.
202
203102 # Only use debug if you're programming an add-on for Skript, but even then you might usually not need it.
204
205103
206
207104
208
209105 plugin priority: high
210
211106 # Allowed values: lowest, low, normal, high, highest
212
213107 # Change this if you encounter problems with other plugins, e.g.:
214
215108 # - cancelled events: The event is cancelled by another plugin, but Skript handles the event nonetheless => increase priority
216
217109 # (e.g. WorldGuard cancels events if a player doesn't have permission for the given region,
218
219110 # and you made some 'place' triggers which should not bypass WorldGuard's protection)
220
221111 # - effects '(un)cancel event': Another plugin should/should not process the event, but does/does not => decrease priority
222
223112 # - effect 'drop': Another plugin doesn't process added drops => decrease priority
224
225113 # - effects 'remove ... from drops'/'clear drops': Drops added by other plugins are not removed => increase priority
226
227114 # Skript removes drops it shouldn't => decrease priority or specify which item types to remove
228
229115
230
231116
232
233117 log player commands: true
234
235118 # Whether Skript should log the usage of custom commands.
236
237119 # They will be logged as [INFORMATION] in this format: '<player>: /<command> <arguments>'
238
239120
240
241121
242
243122 number accuracy: 2
244
245123 # How many digits should be displayed after the dot at maximum when displaying numbers.
246
247124 # 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.
248
249125 # Money bypasses this setting and is displayed as configured in your economy plugin if you have one.
250
251126
252
253127
254
255128 maximum target block distance: 100
256
257129 # How far to search for a player's targeted block in blocks/meters.
258
259130 # Lower values improve performance, but might reduce the usability of your scripts.
260
261131 # 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.
262
263132
264
265133
266
267134 case sensitive: false
268
269135 # Whether Skript's functions should be case sensitive or not.
270
271136 # This e.g. applies to the effect 'replace' and the conditions 'contains' and 'is/is not'.
272
273137 # Variable names are case-insensitive irrespective of this setting.
274
275138
276
277139
278
279140 disable variable conflict warnings: false
280
281141 # Disables warnings of potential variable name conflicts if set to true.
282
283142 # I recommend to not touch this option, but if you do so you should at least set it back to false
284
285143 # whenever you create new scripts with new variables.
286
287144
288
289145
290
291146
292
293147 # ==== Variables ====
294
295148
296
297149 databases:
298
299150 # Databases to store variables in. These can either be used as a simple one-server-storage
300
301151 # where variables are written constantly but only read at server start,
302
303152 # or as a connection between multiple servers by monitoring the database(s) for changes.
304
305153 #
306
307154 # 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.
308
309155 #
310
311156 # To be able to use a database you'll need to download the plugin 'SQLibrary' from http://dev.bukkit.org/server-mods/sqlibrary/files/
312
313157 # and install it in your server's plugin directory like other plugins.
314
315158 #
316
317159 # Please note that '/skript reload' will not reload this section, i.e. you'll have to restart Skript for changes to take effect.
318
319160
320
321161 # 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.
322
323162 database 1:
324
325163 # an example database to describe all possible options.
326
327164
328
329165 type: disabled
330
331166 # The type of this database. Allowed values are 'CSV', 'SQLite', 'MySQL' and 'disabled'.
332
333167 # 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.
334
335168
336
337169 pattern: .*
338
339170 # Defines which variables to save in this database.
340
341171 # This pattern uses Regex syntax, e.g. use 'db_.*' (without the quotes) to store all variables prefixed with 'db_' in this database,
342
343172 # 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).
344
345173 # Please note that variables are only stored in one database, and databases are checked from top to bottom,
346
347174 # e.g. if a variable matches the topmost database's pattern it will be saved there and nowhere else.
348
349175 # BTW: Patterns are checked in a separate thread, i.e. your server likely won't run slower when using complicated patterns.
350
351176
352
353177 monitor changes: false
354
355178 monitor interval: 20 seconds
356
357179 # If 'monitor changes' is set to true, variables will repeatedly be checked for updates in the database (in intervals set in 'monitor interval').
358
359180 # ! Please note that you should set 'pattern', 'monitor changes' and 'monitor interval' to the same values on all servers that access the same database!
360
361181
362
363182 # == MySQL configuration ==
364
365183 host: localhost # Where the database server is located at, e.g. 'example.com', 'localhost', or '192.168.1.100'
366
367184 port: 3306 # 3306 is MySQL's default port, i.e. you likely won't need to change this value
368
369185 user: root
370
371186 password: pass
372
373187 database: skript # The database to use. Skript will automatically create a table 'variables21' in this database if it doesn't exist
374
375188 # (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)
376
377189
378
379190 # == SQLite/CSV configuration ==
380
381191 file: ./plugins/Skript/variables.db
382
383192 # 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).
384
385193 # 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/...').
386
387194
388
389195 backup interval: 2 hours
390
391196 # Creates a backup of the file every so often. This can be useful if you ever want to revert variables to an older state.
392
393197 # Variables are saved constantly no matter what is set here, thus a server crash will never make you loose any variables.
394
395198 # Set this to 0 to disable this feature.
396
397199
398
399200
400
401201 MySQL example:
402
403202 # A MySQL database example, with options unrelated to MySQL removed.
404
405203
406
407204 type: disabled # change to line below to enable this database
408
409205 # type: MySQL
410
411206
412
413207 pattern: synced_.* # this pattern will save all variables that start with 'synced_' in this MySQL database.
414
415208
416
417209 host: localhost
418
419210 port: 3306
420
421211 user: root
422
423212 password: pass
424
425213 database: skript
426
427214
428
429215 monitor changes: true
430
431216 monitor interval: 20 seconds
432
433217
434
435218 SQLite example:
436
437219 # An SQLite database example.
438
439220
440
441221 type: disabled # change to line below to enable this database
442
443222 # type: SQLite
444
445223
446
447224 pattern: db_.* # this pattern will save all variables that start with 'db_' in this SQLite database.
448
449225
450
451226 file: ./plugins/Skript/variables.db
452
453227 # SQLite databases must end in '.db'
454
455228
456
457229 backup interval: 0 # 0 = don't create backups
458
459230 monitor changes: false
460
461231 monitor interval: 20 seconds
462
463232
464
465233 default:
466
467234 # 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.
468
469235 # This is the last database in this list to catch all variables that have not been saved anywhere else.
470
471236 # You can modify this database freely, but make sure to know what you're doing if you don't want to loose any variables.
472
473237
474
475238 type: CSV
476
477239
478
479240 pattern: .*
480
481241
482
483242 file: ./plugins/Skript/variables.csv
484
485243
486
487244 backup interval: 2 hours
488
489245
490
491246 # 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)
492
493247 # 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_'.
494
495248 # Be very cautious when doing this however as unsaved variables cannot be recovered after the server has been stopped.
496
497249 # 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 '(?!-).*'.
498
499250
500
501251
502
503252
504
505253 # ==== Settings that should not be changed ====
506
507254
508
509255 version: ${project.version}
510
511256 # DO NOT CHANGE THIS VALUE MANUALLY!
512
513257 # This saves for which version of Skript this configuration was written for.
514
515258 # If it does not match the version of the .jar file then the config will be updated automatically.