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