skript-variables

skript-variables

Ever forgotten exactly what you named a variable, then had to dig through all your code or inside variables.csv trying to work out which one it was? skript-variables opens every Skript variable on your server in a website. Look through them, fix them, and save them back live.

If you have used /lp editor from LuckPerms, this is the same idea, but for your Skript variables.

How it works

1. Install it. Put the jar in your plugins/ folder and restart. That is the whole setup.

2. Run /skv editor in game. You get a clickable link in chat. Click it and the editor opens with every variable already loaded.

3. Change what you want. Your edits are saved in the browser only. Your server has not changed yet.

4. Run /skv apply <sessionId> <code>. The editor gives you both of these when you are done. Run the command and your changes are written to the server straight away.

Your variables become folders

A variable like {playerdata::uuid::kills} is normally one long line of text. Here it turns into folders you can open and close, like files on your computer:

playerdata 4f9a-2b1c-... kills 148 balance 2,840.5

Much easier than scrolling through thousands of lines.

What you can edit

Almost everything Skript can store:

• Text, numbers and true/false values
• Locations, with separate boxes for world, X, Y, Z, yaw and pitch
• Vectors, which show their length as you type and have a normalize button
• Item types and block data
• Text components (the fancy coloured text kind)
• Dates and timespans
• NBT compounds
• skbee bounds
• oopsk structs, where you can edit each field on its own
• Lists inside lists inside lists

Tricky types like locations do not make you type raw text. You get proper boxes for each part, so it is hard to get wrong.

Finding what you need

• Search by player name. Type Notch and it finds the variables saved under that player's UUID. A UUID is the long code Minecraft uses to identify a player, and you do not have to know it.
• Regex mode if you want to do advanced pattern searching.
• Filters to show only one type, or only the things you have changed.
• Sidebar stats telling you how many variables each section holds, so you can see what is taking up all the space.

Doing a lot at once

• Pick many variables and set them all to the same value in one go
• Rename a variable, or copy it to a new name
• Delete one variable, or wipe out a whole section at once

Is it safe?

Nothing changes until you say so. Everything you do in the browser sits there waiting. Your server is not touched until you run the apply command yourself.

The apply code only works once. After it is used it stops working, so nobody can replay it later. If you actually want to reuse it, add --force on the end.

Only ops can use it. Both permissions default to op, so a random player cannot open your variables.

Your own scripts can block it. VariablesApplyEvent fires before anything is saved, and you can cancel it from Skript if you want extra protection.

Nothing gets missed. Variables still sitting in memory that have not been saved to the file yet are included automatically. You do not have to flush anything first.

Commands

Permissions are skriptvariables.use and skriptvariables.editor. Both are op only by default.

What you need

• Paper 1.21.4 or newer
• Skript 2.14.x to 2.16.x
• Java 21 or newer
• oopsk is optional and only needed for editing structs

Extras

Three colour themes to pick from: Ocean, Slate and Ember. Anonymous usage stats are collected through bStats.

Links

• Website: https://skript-variables.com
• Discord for help and bug reports: https://discord.gg/m4H55rQJzC
• Source code (GPLv3): https://github.com/CJH3139/skript-variables