# Scriptirc – script compiler, compiles java source code directly into a server plugin and loads it.<\/p>\n
**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.**<\/p>\n
## \ud83d\udcda Introduction<\/p>\n
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.<\/p>\n
## \u2728 Key Features<\/p>\n
\ud83d\udd04 Dynamic plugin management – load, unload or reload plugins without restarting the server<\/p>\n
\ud83d\udcdd On-the-fly script compilation – Compile Java scripts directly into fully functional Bukkit plugins<\/p>\n
\ud83d\udee1\ufe0f Data Directory Segregation – Automatically creates separate data directories for plugin scripts<\/p>\n
\ud83d\udd27 Seamless Integration – Compatible with existing Bukkit\/Spigot\/Paper environments<\/p>\n
\ud83d\udd12 Resource Release – Uninstall plugin scripts to completely release plugin resources, unlock JAR files<\/p>\n
## \ud83d\ude80 Installation Instructions<\/p>\n
Download the corresponding version of Scriptirc.jar<\/p>\n
Place the JAR file in the plugins directory of the server<\/p>\n
Restart the server or load the plugin using the plugin manager<\/p>\n
The plugin will automatically create the necessary directory structure and configuration files<\/p>\n
## \ud83d\udca1 Usage<\/p>\n
Scriptirc provides an intuitive command system that allows you to easily manage plugins and scripts:<\/p>\n
Basic commands (all commands can be abbreviated as \/si)<\/p>\n
Command Description<\/p>\n
“` Plugin management example<\/p>\n ## Load a plugin named TestPlugin.<\/p>\n “` ## Uninstall the plugin<\/p>\n “` ## Reload the plugin (e.g. after an update)<\/p>\n “` ## View list of loaded plugins<\/p>\n “` Example of script compilation<\/p>\n ## Compile the HelloWorld.java script located in the script_src directory.<\/p>\n “` ## Then load the compiled plugin.<\/p>\n “` ## \ud83d\udcc2 Directory structure<\/p>\n After installation, Scriptirc will create the following directory structure:<\/p>\n “` ## \ud83d\udee0\ufe0f Development Tutorial – Creating Your First Script Plugin<\/p>\n 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:<\/p>\n ### 1. Create the script file<\/p>\n Create a new Java file in the plugins\/Scriptirc\/script_src directory, e.g. MyFirstPlugin.java.<\/p>\n ### 2. Write the plugin code<\/p>\n Below is a simple plugin template:<\/p>\n The package name is customizable (just try to make sense)<\/p>\n “` import org.bukkit.command.Command; \/** public class MyFirstPlugin extends JavaPlugin {<\/p>\n @Override @Override @Override Official AI is recommended!!! Official Website<\/p>\n ### 3. Compiling and loading your plugin<\/p>\n Use the following commands to compile and load your plugin:<\/p>\n “` It’s as simple as that! Your plugin is now running on the server, no need to restart the server.<\/p>\n “` ## \u2699\ufe0f Configuration file description<\/p>\n ### Scriptirc’s configuration file (config.yml) allows you to customize the behavior of the plugin:<\/p>\n Plugin auto-reload configuration Whether to enable auto-reload Check interval (seconds) verbose-logging: false Plugin management settings External plugins directory, relative to the plugin data folder Whether to automatically load external plugins on server startup. Whether to redirect the data folder of external plugins to the Scriptirc directory. Permission settings Administrator permissions node Whether to allow OP use only ## Logging settings <\/p>\n logging. level: \u201cMINIMAL\u201d ## \ud83e\udd14 Frequently Asked Questions<\/p>\n 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)<\/p>\n The server administrator can run the command \/si sync to synchronize commands to all online players. ## What should I do if I get an error compiling the script?<\/p>\n Make sure:<\/p>\n Java code is syntactically correct<\/p>\n All required metadata fields (VERSION, DESCRIPTION, AUTHOR) are included.<\/p>\n The server is running on JDK and not JRE (JDK is required for compilation)<\/p>\n ## How to remove dynamically loaded plugin files?<\/p>\n 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.<\/p>\n ## Recognize<\/p>\n There is code related to plugin unload loading I refer to the PlugManX project<\/p>\n","protected":false},"excerpt":{"rendered":" AI write plugins for Bukkit\/Spigot\/Paper servers.
\n\/scriptirc help
\n\/scriptirc load
\n\/scriptirc compiler
\n\/scriptirc profile
\n“`<\/p>\n
\n\/si load TestPlugin
\n“`<\/p>\n
\n\/si unload TestPlugin
\n“`<\/p>\n
\n\/si reload TestPlugin
\n“`<\/p>\n
\n\/si list
\n“`<\/p>\n
\n\/si compiler HelloWorld
\n“`<\/p>\n
\n\/si load HelloWorld
\n“`<\/p>\n
\nplugins\/
\n \u2514\u2500\u2500 Scriptirc\/
\n \u251c\u2500\u2500 config.yml # Plugin configuration file
\n \u251c\u2500\u2500 plugins\/ # External plugin storage directory
\n \u2502 \u2514\u2500\u2500 Data\/ # Plugin data directory
\n \u251c\u2500 script_src\/ # Script source code directory \u2502 \u251c\u2500\u2500 script_src\/ # Script source code directory
\n \u2502 \u251c\u2500\u2500 HelloWorld.java # Example scripts
\n \u2502 \u2514\u2500\u2500 MathUtil.java # Example Scripts
\n \u2514\u2500 script_build\/ # Temporary script build directory
\n“`<\/p>\n
\npackage your.package.name;<\/p>\n
\nimport org.bukkit.command.CommandSender;
\nimport org.bukkit.entity.Player;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n
\n* @pluginName
\n* @author
\n* @version
\n* @description
\n* \uff08Commands and permissions are added optionally\uff09
\n* [command]
\n* [command]
\n* [Permission]
\n* [Permission]
\n*\/<\/p>\n
\n public void onEnable() {
\n getLogger().info(“Plugin enabled!”);
\n \/\/ Initializing Code
\n\t\t\t\t\/\/
\n }<\/p>\n
\n public void onDisable() {
\n getLogger().info(“Plugin disabled!”);
\n \/\/ The code for the unload \/ listener \/ command can be placed here.
\n }<\/p>\n
\n public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
\n if (command.getName().equalsIgnoreCase(“myfirstcmd”)) {
\n if (sender instanceof Player) {
\n Player player = (Player) sender;
\n player.sendMessage(“\u00a7aHello, this is my first plugin command!”);
\n } else {
\n sender.sendMessage(“This command can only be executed by the player!”);
\n }
\n return true;
\n }
\n return false;
\n }
\n}
\n“`<\/p>\n
\n\/si compiler MyFirstPlugin
\n\/si load MyFirstPlugin
\n“`<\/p>\n
\nImportant metadata fields
\n|Fields |Required |Description
\n|VERSION |YES |Plugin version number
\n|DESCRIPTION |YES |Plugin Description
\n|AUTHOR |YES |Plugin Author
\n|COMMANDS |No |Plugin command definitions in the form of \u201ccommand name\u201d.
\n|PERMISSIONS |No |Permission definitions in the form of \u201cpermission nodes\u201d.
\n“`<\/p>\n
\nauto-reload.<\/p>\n
\nenabled: true<\/p>\n
\ncheck-interval: 5<\/p>\n
\nverbose-logging: false<\/p>\n
\nplugin-management.<\/p>\n
\nexternal-plugins-directory: \u201cplugins\u201d<\/p>\n
\nload-on-startup: true<\/p>\n
\nredirect-data-folder: true<\/p>\n
\npermissions.<\/p>\n
\nadmin-permission: \u201cscriptirc.admin\u201d<\/p>\n
\nop-only: true<\/p>\n
\nlogging output level: VERBOSE (output all logs), NORMAL (standard output), MINIMAL (output only key information)<\/p>\n
\n(If you encounter a compilation failure, try switching the logging mode to VERBOSE)<\/p>\n
\nOr have players log back into the server.<\/p>\n
\nJust put .java file in the folders to load.<\/p>\n","protected":false},"featured_media":136420,"template":"","meta":{"_minecraft_slug":"scriptirc","_minecraft_project_id":"Ql58FVwI","_minecraft_author":"Player9753193","_minecraft_license":"Apache-2.0","_minecraft_downloads":731,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"scriptirc.zip","_minecraft_size_bytes":26299237,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T09:27:46.171961Z","_minecraft_date_created":"2025-05-28T06:27:34.306719Z","_minecraft_date_modified":"2026-03-28T00:31:59.889538Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/scriptirc","_minecraft_icon_attachment_id":136420,"_minecraft_imported_at":"2026-06-08T01:24:16+00:00","_minecraft_import_hash":"b580e15564ba8e604c602c1cc6ee50e0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,873,126,127,128,129,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-136419","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n