Description
Mochos Scripts
Program your server without writing Java. An addon for Mochos Esenciales with a scripting language in the style of Skript — in Spanish and with the familiar English words — to create commands, react to what happens in the world and build shops, minigames or bosses. Write it as text… or with blocks, like in MCreator.
on join:
send "&aHello, %player%!" to player
command /mend [<player>]:
permission: op
trigger:
heal arg-1
send "&aHealed."

What you can do
- ⚡ Events: join and quit, chat (cancel or change it), breaking and placing blocks, clicks on blocks, items and entities, deaths, damage (change the amount), mob spawns, dropping and picking up items, eating, level ups and shop sales.
- ⌨️ Custom commands with arguments (text, number, integer, player, world; optional ones), permissions, aliases and cooldowns.
- ⏱️ Timers (
every 10 minutes:) and times of day (at 18:00:), andwaitwithout freezing the server. - 🧠 Variables saved with the world, local variables and lists, functions shared between scripts, conditions with
and,orandnot, and loops. - 🧟 Mobs and entities: spawn, name, equip, potion effects, health, fire, push, lightning and explosions.
- 🎁 Items with colored names and lore, inventories, sounds and particles.
- 🛠️ Change items: enchantments, durability and max durability, unbreakable, lore, nbt and any component like in
/give(!componentremoves it); and read them back: durability, an enchantment's level, nbt and its values. - 🔨 Mochos Forja: give, take and recognise its saved items by their invisible mark (even when used up, renamed or enchanted) and put its models on items (a weapon or tool model turns the item into that tool).
- 📦 Chest menus with buttons that run code on click.
- 💰 Mochos Esenciales: pay and charge its money, balances, notices, bank, groups and claimed land.
Over 150 elements, all documented with examples.
Built not to break
- The mod checks every script when loading it and points at the exact line and word of each error, with suggestions ("Did you mean…?").
- A script with errors is not loaded; if it was already loaded, the previous version keeps running.
- Runtime errors and what the script logs go to its log. A loop without waits is stopped before it freezes the server.
Scripts tab
For admins: every script by folder, its state (loaded, with errors, disabled), enable or disable, reload one or all, see the code with the lines that have errors marked, edit it, create, rename, move and send to the trash. Also with /scripts.
Web editor with blocks
/scripts web (or the globe button) opens an editor in the browser with a personal link:
- 🧩 Blocks by category and color, in the style of MCreator.
- 📝 Text with colors, and a split view with both at once: they are the same
.mskfile. - ✅ Checks as you type without locking the blocks: unfinished parts show in grey, errors in amber on their block, and in red when you press Validate or save.
- 💾 Unsaved changes are marked in the list and next to the script's state.
- 📚 Reference of the whole language with examples you insert with a click, and a finder for game ids.
- 📋 Mochos Forja's saved items and models and enchantments are picked from a list in the blocks.
- 🔢 A script's options and variables show as blocks, one row each.
Getting started
It comes with eleven example scripts (disabled) in config/mochos_scripts/scripts/ejemplos: welcome, commands, events, variables, loops, functions, a shop with a menu, announcements, a zombie boss, custom items (with those of Mochos Forja) and the language in English. The full reference is in config/mochos_scripts/REFERENCE.md.
Installation
| Where | Required? |
|---|---|
| Server | Required |
| Client | Required (for the Scripts tab; players without it still see menus and messages) |
Requires Minecraft 1.21.1, NeoForge 21.1.265 or later and Mochos Esenciales 0.29.0 or later. Optional: Mochos Forja 0.4.0 or later to use its saved items and models.
- Scripts:
config/mochos_scripts/scripts/**/*.msk(a-in front of the name disables it). - Web editor: port 8124 (
config/mochos_scripts-common.toml); every link carries a token that expires. - Variables: saved with the world (
<world>/data/mochos_scripts_variables.dat).
Languages: Spanish and English.
