Description
Sqript is a script interpreter for Minecraft 1.12.2 (Forge). Write .sq files in a simple, readable language to add commands, events, chest menus, windows, HUD elements, items and much more, without writing a single line of Java. Scripts are reloaded in game with /sqript reload, no restart needed.
Example:
command /hello:
send "§6Hello %player's name%!" to player
on player join:
set join message to "§a+ §7%player's name%"
Features
- Commands with arguments, permissions and descriptions
- 48 events: join, quit, death, clicks, damage, chat, commands, rendering…
- Chest menus with clickable slots, animations and close actions
- Client windows: texts, buttons, images, text fields, progress bars
- HUD drawing: text, rectangles, lines, circles, textures
- Custom keybinds, sounds, items and blocks
- Global variables saved automatically between restarts
- Client/server packets for multiplayer interfaces
- Functions, imports, options, loops, timed tasks
- Mod messages in English or French (config/sqript.cfg)
- Works in singleplayer, on Forge servers and on hybrid Forge + Bukkit servers (CatServer, Mohist…)
Installation
1. Install Minecraft Forge 1.12.2.
2. Put the jar in the mods folder of the server and of every player (in singleplayer, only yours).
3. Start the game once: a scripts folder is created.
4. Put your .sq files in it, then type /sqript reload in game.
Documentation and examples
The full wiki lists every event, condition, effect, expression and type, each with a complete example to copy, plus 27 ready-to-use scripts (ranks, economy, shops, moderation, GPS…):
https://sqript.netlify.app/en/
The wiki is also available in French: https://sqript.netlify.app/
Discord (help, sharing, updates): https://discord.gg/Pg9kvspjCH
Credits
Sqript was created by Nico (nicoszpako) up to version 1.3.2, with Yanis and Aymeric from the DynamX team and Kerlann.
Original project: https://www.curseforge.com/minecraft/mc-mods/sqript
Original source code by Nico: https://github.com/nicoszpako/Sqript/tree/main
Since version 1.3.3, the mod and the website are developed by Adapts, with Nico's agreement.



