Install Scripts

Installing scripts

Home / Installing scripts

BetaMoon creates .minecraft/betamoon/scripts when it starts. It accepts:

• a single .lua file directly in that folder;
• a packaged Lua mod directory containing betamoon.mod.json;
• a packaged mod ZIP containing betamoon.mod.json at the ZIP root.

Install a single-file mod

1. Copy the package's Lua files into betamoon/scripts.
2. Copy accompanying assets, keeping their directory structure. Texture paths resolve from betamoon/scripts.
3. Include required dependency scripts. The package or example comments identify them.
4. Open BetaMoon's Scripts screen and check the load status and reported errors.

For example:

.minecraft/
  betamoon/
    scripts/
      03_adv_07_gui_showcase.lua
      gui_showcase/
        panel.png
        state_on.png
        ...

For a packaged mod, copy its complete directory or ZIP into betamoon/scripts without extracting or rearranging its internal paths. A ZIP must have betamoon.mod.json at its archive root. See Packaged Lua mods.

Use Reload on the Scripts screen or Ctrl+Shift+R after editing. Reload on save is optional; enable it with scripts.hotReloadOnFileChange=true in .minecraft/config/betamoon.cfg. The setting defaults to disabled and is read at startup. Persistent structural content requires a restart after changes; see Hot reload and compatibility.

Choosing scripts

Use scripts written for the version shown on Home. Check content IDs when combining packages and preserve saved-world identities when updating installed content.

The example index groups the existing scripts by topic and complexity. For your own script, start with Getting started.