# Scriptirc - script compiler, compiles java source code directly into a server plugin and loads it. **This plugin is recommended for test servers or servers under development because the compiled scripts do not need to rely on Scriptirc to load, you can put the compiled plugin scripts directly into plugins.** ## 📚 Introduction Scriptirc is a powerful Bukkit/Spigot plugin designed to simplify plugin management and on-the-fly development processes. If you've ever wanted to be able to compile and modify script plugins, load, unload or reload them without restarting the server, or want to quickly develop and test simple features, Scriptirc is for you. ## ✨ Key Features 🔄 Dynamic plugin management - load, unload or reload plugins without restarting the server 📝 On-the-fly script compilation - Compile Java scripts directly into fully functional Bukkit plugins 🛡️ Data Directory Segregation - Automatically creates separate data directories for plugin scripts 🔧 Seamless Integration - Compatible with existing Bukkit/Spigot/Paper environments 🔒 Resource Release - Uninstall plugin scripts to completely release plugin resources, unlock JAR files ## 🚀 Installation Instructions Download the corresponding version of Scriptirc.jar Place the JAR file in the plugins directory of the server Restart the server or load the plugin using the plugin manager The plugin will automatically create the necessary directory structure and configuration files ## 💡 Usage Scriptirc provides an intuitive command system that allows you to easily manage plugins and scripts: Basic commands (all commands can be abbreviated as /si) Command Description ``` /scriptirc help /scriptirc load /scriptirc unload /scriptirc reload /scriptirc list /scriptirc compiler /scriptirc sync /scriptirc profile ``` Plugin management example ## Load a plugin named TestPlugin. ``` /si load TestPlugin ``` ## Uninstall the plugin ``` /si unload TestPlugin ``` ## Reload the plugin (e.g. after an update) ``` /si reload TestPlugin ``` ## View list of loaded plugins ``` /si list ``` Example of script compilation ## Compile the HelloWorld.java script located in the script_src directory. ``` /si compiler HelloWorld ``` ## Then load the compiled plugin. ``` /si load HelloWorld ``` ## 📂 Directory structure After installation, Scriptirc will create the following directory structure: ``` plugins/ └── Scriptirc/ ├── config.yml # Plugin configuration file ├── plugins/ # External plugin storage directory │ └── Data/ # Plugin data directory ├─ script_src/ # Script source code directory │ ├── script_src/ # Script source code directory │ ├── HelloWorld.java # Example scripts │ └── MathUtil.java # Example Scripts └─ script_build/ # Temporary script build directory ``` ## 🛠️ Development Tutorial - Creating Your First Script Plugin Scriptirc makes plugin development incredibly easy. All you need to do is create a Java source file, compile it and load it for use immediately. Here are the development steps: ### 1. Create the script file Create a new Java file in the plugins/Scriptirc/script_src directory, e.g. MyFirstPlugin.java. ### 2. Write the plugin code Below is a simple plugin template: The package name is customizable (just try to make sense) ``` package your.package.name; import org.bukkit.command.Command; import org.bukkit.command.CommandSender; import org.bukkit.entity.Player; import org.bukkit.plugin.java.JavaPlugin; /** * @pluginName * @author * @version * @description * （Commands and permissions are added optionally） * [command]|description1[/command] * [command]|description2[/command] * [Permission]|description1[/Permission] * [Permission]|description2[/Permission] */ public class MyFirstPlugin extends JavaPlugin { @Override public void onEnable() { getLogger().info("Plugin enabled!"); // Initializing Code // } @Override public void onDisable() { getLogger().info("Plugin disabled!"); // The code for the unload / listener / command can be placed here. } @Override public boolean onCommand(CommandSender sender, Command command, String label, String[] args) { if (command.getName().equalsIgnoreCase("myfirstcmd")) { if (sender instanceof Player) { Player player = (Player) sender; player.sendMessage("§aHello, this is my first plugin command!"); } else { sender.sendMessage("This command can only be executed by the player!"); } return true; } return false; } } ``` Official AI is recommended!!! [Official Website](https://scriptirc.io/) ### 3. Compiling and loading your plugin Use the following commands to compile and load your plugin: ``` /si compiler MyFirstPlugin /si load MyFirstPlugin ``` It's as simple as that! Your plugin is now running on the server, no need to restart the server. ``` Important metadata fields |Fields |Required |Description |VERSION |YES |Plugin version number |DESCRIPTION |YES |Plugin Description |AUTHOR |YES |Plugin Author |COMMANDS |No |Plugin command definitions in the form of “command name”. |PERMISSIONS |No |Permission definitions in the form of “permission nodes”. ``` ## ⚙️ Configuration file description ### Scriptirc's configuration file (config.yml) allows you to customize the behavior of the plugin: Plugin auto-reload configuration auto-reload. Whether to enable auto-reload enabled: true Check interval (seconds) check-interval: 5 verbose-logging: false verbose-logging: false Plugin management settings plugin-management. External plugins directory, relative to the plugin data folder external-plugins-directory: “plugins” Whether to automatically load external plugins on server startup. load-on-startup: true Whether to redirect the data folder of external plugins to the Scriptirc directory. redirect-data-folder: true Permission settings permissions. Administrator permissions node admin-permission: “scriptirc.admin” Whether to allow OP use only op-only: true ## Logging settings logging. logging output level: VERBOSE (output all logs), NORMAL (standard output), MINIMAL (output only key information) level: “MINIMAL” (If you encounter a compilation failure, try switching the logging mode to VERBOSE) ## 🤔 Frequently Asked Questions What if the player can't see the commands after loading the plugin? (There is a slight possibility of a bug that will be fixed later) The server administrator can run the command /si sync to synchronize commands to all online players. Or have players log back into the server. ## What should I do if I get an error compiling the script? Make sure: Java code is syntactically correct All required metadata fields (VERSION, DESCRIPTION, AUTHOR) are included. The server is running on JDK and not JRE (JDK is required for compilation) ## How to remove dynamically loaded plugin files? When unloading a plugin using the /si unload command, Scriptirc tries to completely free the JAR file so that it can be deleted or replaced. If it still cannot be deleted, it may be necessary to restart the server. ## Recognize There is code related to plugin unload loading I refer to the PlugManX project

IonHex975

Organizations