· 5 years ago · Feb 02, 2020, 08:28 AM
1# __________________________________________________________
2# / / / /\ \
3# \_\___________________________________________________\_\/ /
4# / / _____ __ __ / /
5# / / / ____\ / / /_/ /\ / /
6# / / / /__ / /___ ___ __ ______ __/ /_ / /
7# / / \___ \ / __/ / __\ / / / __ //_ __/ / /
8# / / ____/ / / /\ \ / / / / / /_/ / / / / /
9# / / \_____/ /_/ /_/ /_/ /_/ / ____/ /_/ / /__
10# / / ========================== / / ========== / / \ \
11# | | /_/ | | | |
12# \_\_________________________________________________\_\_/_/
13#
14# == Introduction ==
15# This file contains Skript's general options. To write scripts, create a new .sk file in the scripts folder or edit any existing one.
16#
17# 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.
18# This can e.g. be used to temporarily disable scripts and is also used for Skript's example scripts.
19# You can also use the command '/skript enable/disable <script>' to enable/disable a script which will automatically rename it.
20#
21# === !!! PLEASE NOTE !!! ===
22# This file, all scripts and other files ending in .sk are NOT .yml/YAML files, but very similar!
23# Please remember the following when editing files:
24# - 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.
25# - '#' 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")
26# - If you use special characters (§, äöü, éè�?ôç, ñ, etc.) you have to encode the file in UTF-8.
27#
28
29
30
31# ==== General Options ====
32
33language: english
34# Which language to use. Currently english and german are included in the download, but custom languages can be created as well.
35# Please note that not everything can be translated yet, i.e. parts of Skript will still be english if you use another language.
36# If you want to translate Skript to your language please read the readme.txt located in the /lang/ folder in the jar
37# (open the jar as zip or rename it to Skript.zip to access it)
38
39
40check for new version: true
41# Whether Skript should check for whether a new version of Skript is available when the server starts.
42# If this is set to true Skript will announce a new version to all players with the "skript.admin" permission.
43# If set to false you can still check for a new version with '/skript update check'.
44# Please note that Skript will not detect beta releases even if you are running one as they are not necessarily stable.
45
46update check interval: 12 hours
47# If 'check for new version' is enabled, this sets how often to check for a new update.
48# A first check will always be made when the server starts, after that checks will be made in intervals set by this option.
49# Set this to 0 to disable repeated checks, in which case only one check will be made when the server starts.
50# Please note that this option is currently the only means of making Skript check for an update more than once,
51# as '/skript update check' does only display the results of the last check if a check has been made before.
52
53release channel: none
54# If 'check for new version' is enabled, this determines how stable the updates must be.
55# 'stable' means that only stable releases of Skript will be considered updates.
56# 'beta' and 'alpha' mean that also development releases will be checked for.
57# Initial value of this depends on the Skript version you first installed; it was 'none'.
58
59enable effect commands: false
60effect command token: !
61# If 'enable effect commands' is set to true, chat messages starting with the 'effect command token' will be interpreted as effects and executed.
62# The token can be longer than a single character, but it should not start with '/' as that starts a command.
63# A player needs the permission "skript.effectcommands" to use such commands,
64# which does not default to OPs since these commands can do severe damage to the world or crash the server (see below).
65# Some example commands which can be used if this setting is enabled:
66# !heal player - heals the player (doesn't do anything if used from the console)
67# !repair tool - repairs the currently held item
68# !broadcast "<red>Please read the rules!" - if you want to get rid of the quotes you have to define a custom command
69# !set time to 6:00 - sets the time in the current world
70# The command can also be abused, so only give the permission to trusted players, like owners & co-owners:
71# !spawn 20 ender dragons - will destroy a large part of the world in a short time if no protection is present
72# !create explosion of force 10000 - likely crashes the server or at least hangs it up for a long time
73# !ban all players - as the effect implies
74
75allow ops to use effect commands: false
76# Whether server operators which do not have the permission "skript.effectcommands" should have access to effect commands.
77# This setting is mainly useful for servers that do not run any permissions plugin.
78
79player variable fix: true
80# Whether to enable the player variable fix if a player has rejoined and was reciding inside a variable.
81# Player objects inside a variable(list or normal) are not updated to the new player object
82# A server creates whenever a player rejoins.
83# Basically the variable holds the old player object when a player has rejoined thus rendering the variable kinda broken.
84# This fix should work around that and whenever a invalid(old) player object is attempted to be get through a variable
85# It will check if the player is online and then get the valid(new) player object and update the variable object to that one.
86
87use player UUIDs in variable names: false
88# Whether to use a player's UUID instead of their name in variables, e.g. {home.%player%} will look like
89# {home.e5240337-a4a2-39dd-8ed9-e5ce729a8522} instead of {home.njol}.
90# Please note that if this setting is changed old variables WILL NOT be renamed automatically.
91
92
93date format: default
94# The date format to be used when dates should be displayed.
95# This can be 'default' to use Java's default date format for the system's language.
96# The format is that of Java's SimpleDateFormat as defined here: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
97# some examples:
98# d/M/yyyy h:mm a => 15/7/2012 8:53 PM
99# dd.MM.yyyy, HH:mm => 16.03.2013, 09:33
100
101
102verbosity: normal
103# Determines how much info is logged.
104# Allowed values: low, normal, high, very high, debug
105# The highest you should go is very high, which prints quite a lot of useful information,
106# including how much time each trigger takes to execute.
107# Only use debug if you're programming an add-on for Skript, but even then you might usually not need it.
108
109
110plugin priority: high
111# Allowed values: lowest, low, normal, high, highest
112# Change this if you encounter problems with other plugins, e.g.:
113# - cancelled events: The event is cancelled by another plugin, but Skript handles the event nonetheless => increase priority
114# (e.g. WorldGuard cancels events if a player doesn't have permission for the given region,
115# and you made some 'place' triggers which should not bypass WorldGuard's protection)
116# - effects '(un)cancel event': Another plugin should/should not process the event, but does/does not => decrease priority
117# - effect 'drop': Another plugin doesn't process added drops => decrease priority
118# - effects 'remove ... from drops'/'clear drops': Drops added by other plugins are not removed => increase priority
119# Skript removes drops it shouldn't => decrease priority or specify which item types to remove
120
121
122log player commands: true
123# Whether Skript should log the usage of custom commands.
124# They will be logged as [INFORMATION] in this format: '<player>: /<command> <arguments>'
125
126
127number accuracy: 2
128# How many digits should be displayed after the dot at maximum when displaying numbers.
129# 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.
130# Money bypasses this setting and is displayed as configured in your economy plugin if you have one.
131
132
133maximum target block distance: 100
134# How far to search for a player's targeted block in blocks/meters.
135# Lower values improve performance, but might reduce the usability of your scripts.
136# 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.
137
138
139case sensitive: false
140# Whether Skript's functions should be case sensitive or not.
141# This e.g. applies to the effect 'replace' and the conditions 'contains' and 'is/is not'.
142# Variable names are case-insensitive irrespective of this setting.
143
144disable variable conflict warnings: false
145# Disables warnings of potential variable name conflicts if set to true.
146# I recommend to not touch this option, but if you do so you should at least set it back to false
147# whenever you create new scripts with new variables.
148
149disable variable will not be saved warnings: false
150# Disables the "... i.e contents cannot be saved ..." warning when reloading and something in your scripts sets a variable(non local) to a value that is not serializable.
151# By Mirre.
152
153disable variable missing and/or warnings: false
154# Disables the "List is missing 'and' or 'or', defaulting to 'and'" warning when reloading your script.
155
156disable starting a variable's name with an expression warnings: false
157# Disables the "Starting a variable's name with an expression is discouraged..." warnings
158
159soft api exceptions: false
160# Allows Skript to ignore certain actions which would normally result in thrown exceptions.
161# If everything works correctly, you should keep this option disabled. It might cause problems in some cases.
162# However, if Skript or addons of it are not working correctly, this might help.
163# You may also get told to enable this by Skript or addon developers - then do so.
164
165enable timings: false
166# When enabled, triggers in scripts will be present in timings reports.
167# Note that this requires Paper (https://paper.readthedocs.io/en/paper-1.11/) to work; on Bukkit/Spigot this option has no effect.
168# When false, timings are not enabled for scripts even if you're running Paper.
169
170parse links in chat messages: disabled
171# Controls how Skript will try to parse links in chat messages.
172# If 'disabled' or 'false', no links will be automatically parsed.
173# When 'strict', everything starting with http(s):// will be parsed as link.
174# When 'lenient', everything that contains a dot will be interpreted as a link.
175
176color codes reset formatting: true
177# With old Minecraft chat protocol, color codes used to reset formatting of text.
178# With JSON-based new chat protocol, this is not necessary, but can be done
179# manually for compatibility. This is done by default for compatibility.
180
181keep command last usage dates: false
182# When a cooldown is set on a command, the last usage date is kept in memory (or in a variable if cooldown storage is specified),
183# but when the player uses the command again after the cooldown period is over, the last usage will be deleted as it's no longer needed,
184# If you need to use the expression 'last usage date', then you'll want to enable this.
185
186# ==== Variables ====
187
188databases:
189 # Databases to store variables in. These can either be used as a simple one-server-storage
190 # where variables are written constantly but only read at server start,
191 # or as a connection between multiple servers by monitoring the database(s) for changes.
192 #
193 # 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.
194 #
195 # To be able to use a database you'll need to download the plugin 'SQLibrary' from https://dev.bukkit.org/projects/sqlibrary/files
196 # and install it in your server's plugin directory like other plugins.
197 #
198 # Please note that '/skript reload' will not reload this section, i.e. you'll have to restart Skript for changes to take effect.
199
200 # 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.
201 database 1:
202 # An example database to describe all possible options.
203
204 type: disabled
205 # The type of this database. Allowed values are 'CSV', 'SQLite', 'MySQL' and 'disabled'.
206 # 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.
207
208 pattern: .*
209 # Defines which variables to save in this database.
210 # This pattern uses Regex syntax, e.g. use 'db_.*' (without the quotes) to store all variables prefixed with 'db_' in this database,
211 # 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).
212 # Please note that variables are only stored in one database, and databases are checked from top to bottom,
213 # e.g. if a variable matches the topmost database's pattern it will be saved there and nowhere else.
214 # BTW: Patterns are checked in a separate thread, i.e. your server likely won't run slower when using complicated patterns.
215
216 monitor changes: false
217 monitor interval: 20 seconds
218 # If 'monitor changes' is set to true, variables will repeatedly be checked for updates in the database (in intervals set in 'monitor interval').
219 # ! Please note that you should set 'pattern', 'monitor changes' and 'monitor interval' to the same values on all servers that access the same database!
220
221 # == MySQL configuration ==
222 host: localhost# Where the database server is located at, e.g. 'example.com', 'localhost', or '192.168.1.100'
223 port: 3306# 3306 is MySQL's default port, i.e. you likely won't need to change this value
224 user: root
225 password: pass
226 database: skript# The database to use, the table will be created in this database.
227 table: variables21# The name of the table to create. 'variables21' is the default name, if this was to be omitted.
228 # (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)
229 # == SQLite/CSV configuration ==
230 file: ./plugins/Skript/variables.db
231 # 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).
232 # 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/...').
233
234 #table: variables21
235 # The name of the table to create. 'variables21' is the default name, if this was to be omitted.
236 # (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)
237 # This is generally not required as the the .db file will only be used by Skript, unless you want to split different variables into different tables
238
239 backup interval: 2 hours
240 # Creates a backup of the file every so often. This can be useful if you ever want to revert variables to an older state.
241 # Variables are saved constantly no matter what is set here, thus a server crash will never make you loose any variables.
242 # Set this to 0 to disable this feature.
243
244
245 MySQL example:
246 # A MySQL database example, with options unrelated to MySQL removed.
247
248 type: disabled# change to line below to enable this database
249 # type: MySQL
250
251 pattern: synced_.*# this pattern will save all variables that start with 'synced_' in this MySQL database.
252
253 host: localhost
254 port: 3306
255 user: root
256 password: pass
257 database: skript
258 table: variables21
259
260 monitor changes: true
261 monitor interval: 20 seconds
262
263 SQLite example:
264 # An SQLite database example.
265
266 type: disabled# change to line below to enable this database
267 # type: SQLite
268
269 pattern: db_.*# this pattern will save all variables that start with 'db_' in this SQLite database.
270
271 file: ./plugins/Skript/variables.db
272 # SQLite databases must end in '.db'
273 #table: variables21
274 # Usually not required, if omitted defaults to variables21 (see above for more details)
275
276 backup interval: 0# 0 = don't create backups
277 monitor changes: false
278 monitor interval: 20 seconds
279
280 default:
281 # 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.
282 # This is the last database in this list to catch all variables that have not been saved anywhere else.
283 # You can modify this database freely, but make sure to know what you're doing if you don't want to loose any variables.
284
285 type: CSV
286
287 pattern: .*
288
289 file: ./plugins/Skript/variables.csv
290
291 backup interval: 2 hours
292
293 # 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)
294 # 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_'.
295 # Be very cautious when doing this however as unsaved variables cannot be recovered after the server has been stopped.
296 # 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 '(?!-).*'.
297
298
299
300 # ==== Settings that should not be changed ====
301
302version: 2.3.6
303# DO NOT CHANGE THIS VALUE MANUALLY!
304# This saves for which version of Skript this configuration was written for.
305# If it does not match the version of the .jar file then the config will be updated automatically.