# \ud83d\ude80 MC-JS – JavaScript Plugin System for Minecraft<\/p>\n
**Write Minecraft Server Plugins in JavaScript – No Java Required!**<\/p>\n
MC-JS is a powerful plugin system that allows you to develop server plugins using modern JavaScript (ES6+) instead of Java. Perfect for developers who already know JavaScript or want to quickly create plugins without having to learn Java.<\/p>\n
## \u2728 Key Features<\/p>\n
### \ud83c\udfaf Core Capabilities<\/p>\n
– **\ud83d\udcdd Full JavaScript Support** – Develop plugins in modern JavaScript using the Rhino Engine
\n– **\u26a1 Hot Reload** – Reload plugins without server restart (`\/jsreload`)
\n– **\ud83d\udd27 Complete API Access** – Access to virtually all Bukkit\/Spigot\/Paper API functions
\n– **\ud83c\udfae Event System** – Register listeners for any Minecraft event with priority support
\n– **\ud83d\udcac Command System** – Create custom commands with full tab completion support
\n– **\u23f0 Task Scheduling** – Synchronous and asynchronous task scheduling
\n– **\ud83d\udce6 Inventory Management** – Create and manage custom GUI menus using standard Bukkit inventories (9-54 slots) with click handlers
\n– **\ud83d\uddc4\ufe0f Database Support** – Built-in SQLite database operations (INSERT, UPDATE, DELETE, SELECT)
\n– **\ud83c\udf10 HTTP Requests** – Make HTTP GET\/POST requests asynchronously
\n– **\ud83d\udd10 Encryption** – MD5, SHA256, Base64 encoding\/decoding
\n– **\ud83d\udcc1 File I\/O** – YAML, JSON, and text file support
\n– **\ud83c\udfa8 BossBar Support** – Create and manage boss bars with progress tracking
\n– **\u23f1\ufe0f Cooldown System** – Built-in cooldown management per player
\n– **\u2699\ufe0f Config System** – Per-plugin configuration files (YAML)
\n– **\ud83c\udf0d World Management** – Control weather, time, world border, explosions
\n– **\ud83c\udfaf Entity Management** – Spawn, control, and customize entities
\n– **\ud83d\udd12 Player Management** – Ban, kick, teleport, health, food, gamemode<\/p>\n
### \ud83d\udee0\ufe0f Advanced Features<\/p>\n
– **\ud83c\udfa8 Particle Effects** – Spawn particles with string or enum support
\n– **\ud83d\udd0a Sound System** – Play sounds at locations or for players
\n– **\ud83d\udcca Scoreboard System** – Create and manage scoreboards, teams, objectives
\n– **\ud83d\udcdd Item Manipulation** – Create, modify, and manage items with custom names and lore
\n– **\ud83d\udd12 Permission System** – Check and manage player permissions
\n– **\ud83c\udfa8 Color Support** – Minecraft color codes and formatting utilities
\n– **\ud83c\udf10 HTTP Integration** – Make external API calls and web requests
\n– **\ud83d\udcca Economy Integration** – Vault economy support for server economies<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
### Requirements<\/p>\n
– **Minecraft Server**: Paper\/Spigot 1.20+ (recommended: Paper)
\n– **Java**: Version 21 or higher
\n– **Minecraft Version**: 1.20+<\/p>\n
### Steps<\/p>\n
1. **Download the latest release** from the Releases page
\n2. **Place the JAR file** in your server’s `plugins\/` folder
\n3. **Start or restart** your server
\n4. **Create JS plugins** in `plugins\/MC-JS\/js-plugins\/` directory<\/p>\n
The plugin will automatically create the `js-plugins` directory and copy an example plugin on first run.<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
### Creating Your First Plugin<\/p>\n
1. **Navigate to** `plugins\/MC-JS\/js-plugins\/` directory
\n2. **Create a new file** with `.js` extension (e.g., `myplugin.js`)
\n3. **Add the following code**:<\/p>\n
“`javascript
\nvar pluginInfo = {
\n name: “My First Plugin”,
\n version: “1.0.0”,
\n author: “YourName”,
\n description: “My awesome plugin!”
\n};<\/p>\n
function onEnable() {
\n logger.info(“My plugin is enabled!”);<\/p>\n
\/\/ Register a command
\n api.registerCommand(“hello”, “Say hello”, “\/hello”, function(sender, args) {
\n api.sendMessage(sender, “&aHello from JavaScript!”);
\n return true;
\n });<\/p>\n
\/\/ Register an event
\n api.registerEvent(“player.PlayerJoinEvent”, function(event) {
\n var player = event.getPlayer();
\n api.sendMessage(player, “&6Welcome to the server!”);
\n });
\n}<\/p>\n
function onDisable() {
\n logger.info(“My plugin is disabled!”);
\n}<\/p>\n
this.onEnable = onEnable;
\nthis.onDisable = onDisable;
\nthis.pluginInfo = pluginInfo;
\n“`<\/p>\n
4. **Save the file** – The plugin will auto-load on server start, or use `\/jsreload` to reload
\n5. **Test your command** – Type `\/hello` in-game or in console
\n6. **Check console** – Look for “My plugin is enabled!” message<\/p>\n
> \ud83d\udca1 **Tip**: Use `\/jslist` to see all loaded JavaScript plugins and `\/jsreload ## \ud83d\udcda Available Objects<\/p>\n These objects are automatically available in all JavaScript plugins:<\/p>\n | Object | Description | Usage | ## \ud83c\udfae Commands<\/p>\n | Command | Description | Permission | ## \ud83d\udcd6 Documentation<\/p>\n > **\ud83d\udcd6 Full Documentation**: Visit our complete documentation website for detailed API reference, examples, and guides.<\/p>\n ## \ud83d\udca1 Example Applications<\/p>\n – **Welcome Plugins** – Greet players with messages, titles, and sounds ## \ud83d\udee0\ufe0f Technical Details<\/p>\n – **JavaScript Engine**: Rhino (Mozilla) ## \ud83e\udd1d Support<\/p>\n – **GitHub**: LootingVI\/MC-JS ## \ud83d\udcdd License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n —<\/p>\n **Made with \u2764\ufe0f for the Minecraft Community** —<\/p>\n","protected":false},"excerpt":{"rendered":" Create Minecraft plugins in JavaScript instead of Java! Full Bukkit\/Spigot\/Paper API, Hot-Reload, Events, Commands, Databases, GUIs and more.<\/p>\n","protected":false},"featured_media":99090,"template":"","meta":{"_minecraft_slug":"mc-js","_minecraft_project_id":"bDI16plG","_minecraft_author":"LootingVI","_minecraft_license":"MIT","_minecraft_downloads":280,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mc-js.zip","_minecraft_size_bytes":29809045,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T11:56:56.581625Z","_minecraft_date_created":"2026-01-31T23:25:04.378503Z","_minecraft_date_modified":"2026-02-07T14:32:54.445324Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mc-js","_minecraft_icon_attachment_id":99090,"_minecraft_imported_at":"2026-06-05T16:38:15+00:00","_minecraft_import_hash":"aec0ff16ff824bb3ef84b529953265b8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,129],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-99089","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","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
\n|——–|————-|——-|
\n| `api` | Complete JS API wrapper – main interface for all operations | `api.registerCommand(…)` |
\n| `server` | Minecraft server instance | `server.getOnlinePlayers()` |
\n| `plugin` | Main plugin instance | `plugin.getName()` |
\n| `logger` | Plugin logger | `logger.info(“Message”)` |
\n| `scheduler` | Server scheduler | `scheduler.runTask(…)` |
\n| `Bukkit` | Direct Bukkit API access | `Bukkit.getServer()` |<\/p>\n
\n|———|————-|————|
\n| `\/jsreload` | Reload all JS plugins | `mcjs.admin` |
\n| `\/jsreload
\n| `\/jslist` | List all loaded JS plugins | `mcjs.admin` |
\n| `\/jsconfig` | View or reload plugin configuration | `mcjs.admin` |<\/p>\n
\n– **Statistics Systems** – Track player statistics with SQLite databases
\n– **Custom GUI Menus** – Create interactive menus using standard Bukkit inventories with custom layouts and click handlers
\n– **Mini-Games** – Develop simple games with event handling
\n– **Utility Plugins** – Create helpful tools and commands
\n– **Integration Plugins** – Connect your server with external APIs<\/p>\n
\n– **API Version**: 1.21
\n– **Compatibility**: Paper, Spigot, Bukkit
\n– **License**: MIT<\/p>\n
\n– **Issues**: GitHub Issues
\n– **Documentation**: lootingvi.github.io\/MC-JS<\/p>\n
\n“`<\/p>\n