# {Kode}<\/p>\n
*Script your server without writing Java.*<\/p>\n
\ud83c\udf10 Website \u2022 \ud83d\udcd6 Documentation \u2022 \ud83d\uddb1\ufe0f Visual Scripter \u2022 \ud83d\udcac Discord<\/p>\n
—<\/p>\n
## \u2605 Don’t want to type? Script visually in your browser \u2014 no install needed! \u2605<\/p>\n
\u2192 Open the Visual Scripter at kode.viirless.net\/scripter \u2190
\n*Drag nodes \u00b7 Connect them \u00b7 Download your .kode file \u00b7 Done.*<\/p>\n
—<\/p>\n
## What is Kode?<\/p>\n
**Kode** is a plain-text scripting plugin for **Paper and Spigot 1.21+**. Drop a `.kode` file into `plugins\/Kode\/scripts\/`, run `\/kode reload`, and your script goes live \u2014 no Java, no compilation, no server restarts. <\/p>\n
Whether you want a simple join message, a full coin economy, or custom level rewards \u2014 Kode handles it all in a clean, Python-like syntax that anyone can learn in minutes. And if typing isn’t your thing, the free **Visual Scripter** on the website lets you build scripts by dragging and connecting nodes right in your browser.<\/p>\n
—<\/p>\n
## \u2726 Visual Scripter<\/p>\n
**No code? No problem.** The online Visual Scripter at kode.viirless.net\/scripter is a full drag-and-drop node editor:<\/p>\n
– Drag events, actions, variables, and control-flow nodes onto the canvas
\n– Wire them together with a click
\n– Hit **Generate Script** and download your finished `.kode` file
\n– **Free**, runs in any browser, no account or install required<\/p>\n
Event: PlayerJoin \u2500\u2500\u2192 Send Message: “&aWelcome, {player.name}!”
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u2514\u2500\u2500\u2192 Give Item: bread \u00d7 4
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u2514\u2500\u2500\u2192 Title: “&6Welcome!” <\/p>\n
Command: \/kit \u2500\u2500\u2192 Give Item: iron_sword \u00d7 1 \u2500\u2500\u2192 Play Sound: BLOCK_CHEST_OPEN <\/p>\n
—<\/p>\n
## Features<\/p>\n
– **\ud83d\uddb1\ufe0f Visual Scripter** \u2013 Build scripts online by dragging nodes \u2014 no typing required. Try it free
\n– **\u26a1 Hot Reload** \u2013 Edit any `.kode` file and run `\/kode reload`. Changes go live instantly with zero restarts
\n– **\ud83c\udfae Custom Commands** \u2013 Define `\/kit`, `\/balance`, or any slash command with a `command \/name:` block. No plugin.yml needed
\n– **\ud83d\udd12 Command Permissions** \u2013 Lock any command behind a permission node with `[permission: myserver.use]`. Set a custom denial message with `[no-permission: “&cAdmins only!”]`
\n– **\u23f1\ufe0f Command Cooldowns** \u2013 Add per-player cooldowns to any command with `[cooldown: 60]` (seconds)
\n– **\ud83d\udce6 Persistent Storage** \u2013 Save and load data across restarts with `store` and `load`. Per-player balances, visit counters \u2014 all built in
\n– **\ud83d\udd01 Full Control Flow** \u2013 `if\/else`, `while`, `for`, `switch\/case`, `try\/catch`, `break`, `continue` \u2014 a complete language
\n– **\ud83e\udde9 Functions** \u2013 Define reusable functions with parameters and return values. Namespace them across scripts
\n– **\ud83d\udce1 30 Events** \u2013 React to PlayerJoin, BlockBreak, EntityDeath, PlayerInteract, FurnaceSmelt, EntityDamageByEntity, and more \u2014 with optional entity type filters
\n– **\ud83d\udd23 Built-in Functions** \u2013 String, math, and server functions: `len`, `contains`, `replace`, `random`, `round`, `pow`, `online()`, `world()`, `hasPermission()`, and more
\n– **\ud83c\udf0d World Control** \u2013 Set player game mode (`gamemode creative`), world weather (`weather clear`), and world time (`time day`) directly from scripts
\n– **\ud83d\udd17 Plugin Interop** \u2013 Call EssentialsX, Vault, or any other plugin with `execute` (as player) or `console` (as server)
\n– **\u2728 Custom Events** \u2013 Scripts can talk to each other with `emit` and `on customEvent:`
\n– **\ud83d\udcdd No Java Required** \u2013 Completely standalone. No API knowledge, no build tools, no IDE<\/p>\n
—<\/p>\n
## Quick Example<\/p>\n
# Welcome players and reward milestones
\non PlayerJoin:
\n\u00a0\u00a0\u00a0 send “&aWelcome back, player.name!” to player
\n\u00a0\u00a0\u00a0 load $visits from visits_player.name
\n\u00a0\u00a0\u00a0 set $visits = $visits + 1
\n\u00a0\u00a0\u00a0 store visits_player.name $visits
\n\u00a0\u00a0\u00a0 set $count = online()
\n\u00a0\u00a0\u00a0 send “&7There are &e$count&7 players online.” to player <\/p>\n
\u00a0\u00a0\u00a0 if $visits == 1:
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 give player diamond 1
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 send “&bFirst visit reward: 1 Diamond!” to player <\/p>\n
# Locked command with custom denial message and cooldown
\ncommand \/daily [permission: myserver.daily] [no-permission: “&cYou can’t claim daily rewards.”] [cooldown: 86400]:
\n\u00a0\u00a0\u00a0 give player diamond 3
\n\u00a0\u00a0\u00a0 give_xp 500
\n\u00a0\u00a0\u00a0 send “&aDaily reward claimed! See you tomorrow.” to player <\/p>\n
# World control \u2014 admin commands
\ncommand \/day [permission: myserver.time]:
\n\u00a0\u00a0\u00a0 time day
\n\u00a0\u00a0\u00a0 weather clear
\n\u00a0\u00a0\u00a0 send “&eThe sun rises!” to player <\/p>\n
command \/gmc [permission: myserver.gmc]:
\n\u00a0\u00a0\u00a0 gamemode creative
\n\u00a0\u00a0\u00a0 send “&aCreative mode enabled.” to player <\/p>\n
# Level milestone rewards
\non PlayerLevelChange:
\n\u00a0\u00a0\u00a0 switch player.level:
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 case 10:
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 give player iron_sword 1
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 send “&7Level 10 reward: Iron Sword!” to player
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 case 25:
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 give player diamond_sword 1
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 broadcast “&bplayer.name reached Level 25!”
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 case 50:
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 give player netherite_sword 1
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 broadcast “&5player.name reached Level 50!” <\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download `kode-1.4.1.jar` and drop it into your `plugins\/` folder
\n2. Start or restart your server
\n3. Kode creates `plugins\/Kode\/scripts\/` and installs example scripts automatically
\n4. Edit or create `.kode` files, then run `\/kode reload`
\n5. Or visit kode.viirless.net\/scripter to build scripts visually and download them <\/p>\n
**That’s it.** No configuration required to get started<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
– `\/kode reload` \u2014 Reload all scripts from disk Alias: `\/kd` \u2014 Permission: `kode.use` (default: OP)<\/p>\n —<\/p>\n ## Requirements<\/p>\n – **Java** 17 or newer —<\/p>\n ## Resources<\/p>\n – \ud83c\udf10 Website \u2014 Full landing page with feature overview —<\/p>\n \u00a9 2026 Kode. All rights reserved. Redistribution, resale, or re-release of this software in original or modified form is strictly prohibited.<\/p>\n","protected":false},"excerpt":{"rendered":" Kode is a plugin that allows users to create their own functionality without writing traditional code. With Kode, scripts are written in plain English-style commands and can act like mini plugins<\/p>\n","protected":false},"featured_media":90874,"template":"","meta":{"_minecraft_slug":"kode","_minecraft_project_id":"Zp2qAVsU","_minecraft_author":"viirless1","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"kode.zip","_minecraft_size_bytes":379562,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:30:48.693069Z","_minecraft_date_created":"2026-03-23T23:05:40.342849Z","_minecraft_date_modified":"2026-03-30T07:50:36.590215Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/kode","_minecraft_icon_attachment_id":90874,"_minecraft_imported_at":"2026-06-05T04:31:52+00:00","_minecraft_import_hash":"ea86f3dffa38b62501540f8cebc37f9a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,127,128,129,123,92],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-90873","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","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– `\/kode run
\n– `\/kode list` \u2014 List all loaded scripts <\/p>\n
\n– **Paper or Spigot** 1.21.1+
\n– \u274c Not supported: CraftBukkit, Forge, Fabric<\/p>\n
\n– \ud83d\uddb1\ufe0f Visual Scripter \u2014 Build scripts online with drag-and-drop nodes
\n– \ud83d\udcd6 Documentation \u2014 Complete reference: variables, events, actions, functions, examples
\n– \ud83d\udcac Discord \u2014 Get support, share scripts, and suggest features<\/p>\n