· 7 years ago · Sep 21, 2018, 01:00 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: true
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
163use player UUIDs in variable names: false
164
165# Whether to use a player's UUID instead of their name in variables, e.g. {home.%player%} will look like
166
167# {home.e5240337-a4a2-39dd-8ed9-e5ce729a8522} instead of {home.njol}.
168
169# Please note that if this setting is changed old variables WILL NOT be renamed automatically.
170
171
172
173
174
175date format: default
176
177# The date format to be used when dates should be displayed.
178
179# This can be 'default' to use Java's default date format for the system's language.
180
181# The format is that of Java's SimpleDateFormat as defined here: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
182
183# some examples:
184
185# d/M/yyyy h:mm a => 15/7/2012 8:53 PM
186
187# dd.MM.yyyy, HH:mm => 16.03.2013, 09:33
188
189
190
191
192
193verbosity: normal
194
195# Determines how much info is logged.
196
197# Allowed values: low, normal, high, very high, debug
198
199# The highest you should go is very high, which prints quite a lot of useful information,
200
201# including how much time each trigger takes to execute.
202
203# Only use debug if you're programming an add-on for Skript, but even then you might usually not need it.
204
205
206
207
208
209plugin priority: high
210
211# Allowed values: lowest, low, normal, high, highest
212
213# Change this if you encounter problems with other plugins, e.g.:
214
215# - cancelled events: The event is cancelled by another plugin, but Skript handles the event nonetheless => increase priority
216
217# (e.g. WorldGuard cancels events if a player doesn't have permission for the given region,
218
219# and you made some 'place' triggers which should not bypass WorldGuard's protection)
220
221# - effects '(un)cancel event': Another plugin should/should not process the event, but does/does not => decrease priority
222
223# - effect 'drop': Another plugin doesn't process added drops => decrease priority
224
225# - effects 'remove ... from drops'/'clear drops': Drops added by other plugins are not removed => increase priority
226
227# Skript removes drops it shouldn't => decrease priority or specify which item types to remove
228
229
230
231
232
233log player commands: true
234
235# Whether Skript should log the usage of custom commands.
236
237# They will be logged as [INFORMATION] in this format: '<player>: /<command> <arguments>'
238
239
240
241
242
243number accuracy: 2
244
245# How many digits should be displayed after the dot at maximum when displaying numbers.
246
247# 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
249# Money bypasses this setting and is displayed as configured in your economy plugin if you have one.
250
251
252
253
254
255maximum target block distance: 100
256
257# How far to search for a player's targeted block in blocks/meters.
258
259# Lower values improve performance, but might reduce the usability of your scripts.
260
261# 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
263
264
265
266
267case sensitive: false
268
269# Whether Skript's functions should be case sensitive or not.
270
271# This e.g. applies to the effect 'replace' and the conditions 'contains' and 'is/is not'.
272
273# Variable names are case-insensitive irrespective of this setting.
274
275
276
277
278
279disable variable conflict warnings: false
280
281# Disables warnings of potential variable name conflicts if set to true.
282
283# I recommend to not touch this option, but if you do so you should at least set it back to false
284
285# whenever you create new scripts with new variables.
286
287
288
289
290
291
292
293# ==== Variables ====
294
295
296
297databases:
298
299 # Databases to store variables in. These can either be used as a simple one-server-storage
300
301 # where variables are written constantly but only read at server start,
302
303 # or as a connection between multiple servers by monitoring the database(s) for changes.
304
305 #
306
307 # 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
309 #
310
311 # 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
313 # and install it in your server's plugin directory like other plugins.
314
315 #
316
317 # Please note that '/skript reload' will not reload this section, i.e. you'll have to restart Skript for changes to take effect.
318
319
320
321 # 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
323 database 1:
324
325 # an example database to describe all possible options.
326
327
328
329 type: disabled
330
331 # The type of this database. Allowed values are 'CSV', 'SQLite', 'MySQL' and 'disabled'.
332
333 # 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
335
336
337 pattern: .*
338
339 # Defines which variables to save in this database.
340
341 # This pattern uses Regex syntax, e.g. use 'db_.*' (without the quotes) to store all variables prefixed with 'db_' in this database,
342
343 # 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
345 # Please note that variables are only stored in one database, and databases are checked from top to bottom,
346
347 # e.g. if a variable matches the topmost database's pattern it will be saved there and nowhere else.
348
349 # BTW: Patterns are checked in a separate thread, i.e. your server likely won't run slower when using complicated patterns.
350
351
352
353 monitor changes: false
354
355 monitor interval: 20 seconds
356
357 # If 'monitor changes' is set to true, variables will repeatedly be checked for updates in the database (in intervals set in 'monitor interval').
358
359 # ! 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
361
362
363 # == MySQL configuration ==
364
365 host: localhost # Where the database server is located at, e.g. 'example.com', 'localhost', or '192.168.1.100'
366
367 port: 3306 # 3306 is MySQL's default port, i.e. you likely won't need to change this value
368
369 user: root
370
371 password: pass
372
373 database: skript # The database to use. Skript will automatically create a table 'variables21' in this database if it doesn't exist
374
375 # (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
377
378
379 # == SQLite/CSV configuration ==
380
381 file: ./plugins/Skript/variables.db
382
383 # 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
385 # 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
387
388
389 backup interval: 2 hours
390
391 # 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
393 # Variables are saved constantly no matter what is set here, thus a server crash will never make you loose any variables.
394
395 # Set this to 0 to disable this feature.
396
397
398
399
400
401 MySQL example:
402
403 # A MySQL database example, with options unrelated to MySQL removed.
404
405
406
407 type: disabled # change to line below to enable this database
408
409 # type: MySQL
410
411
412
413 pattern: synced_.* # this pattern will save all variables that start with 'synced_' in this MySQL database.
414
415
416
417 host: localhost
418
419 port: 3306
420
421 user: root
422
423 password: pass
424
425 database: skript
426
427
428
429 monitor changes: true
430
431 monitor interval: 20 seconds
432
433
434
435 SQLite example:
436
437 # An SQLite database example.
438
439
440
441 type: disabled # change to line below to enable this database
442
443 # type: SQLite
444
445
446
447 pattern: db_.* # this pattern will save all variables that start with 'db_' in this SQLite database.
448
449
450
451 file: ./plugins/Skript/variables.db
452
453 # SQLite databases must end in '.db'
454
455
456
457 backup interval: 0 # 0 = don't create backups
458
459 monitor changes: false
460
461 monitor interval: 20 seconds
462
463
464
465 default:
466
467 # 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
469 # This is the last database in this list to catch all variables that have not been saved anywhere else.
470
471 # 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
473
474
475 type: CSV
476
477
478
479 pattern: .*
480
481
482
483 file: ./plugins/Skript/variables.csv
484
485
486
487 backup interval: 2 hours
488
489
490
491 # 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
493 # 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
495 # Be very cautious when doing this however as unsaved variables cannot be recovered after the server has been stopped.
496
497 # 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
499
500
501
502
503
504
505# ==== Settings that should not be changed ====
506
507
508
509version: ${project.version}
510
511# DO NOT CHANGE THIS VALUE MANUALLY!
512
513# This saves for which version of Skript this configuration was written for.
514
515# If it does not match the version of the .jar file then the config will be updated automatically.