Repository navigation
Releases
PotatoMC Beta 3.0
Welcome to the Beta 3.0 release of PotatoMC! This release represents a monumental leap in performance, full protocol compatibility for Minecraft 26.3 (Protocol 777), brand-new 26.3 blocks and mechanics, and a record-breaking 515+ chunks/second world generation pipeline.
Direct Downloads
| Platform / Host | Download Link | Description |
|---|---|---|
| Pterodactyl & Game Panels | server.jar | Universal Bootstrap JAR for Pterodactyl, Multicraft, and panel hosts |
| Windows (x86_64) | potato-windows-x86_64.exe | Standalone Windows 64-bit Server Binary (Optimized Release) |
| Linux (x86_64 MUSL) | potato-linux-x86_64 | Standalone Static Linux Binary (Ubuntu, Debian, Alpine, Arch, RHEL) |
| macOS (Apple Silicon M1/M2/M3/M4) | potato-macos-arm64 | Standalone Native macOS ARM64 Binary |
| macOS (Intel x86_64) | potato-macos-x86_64 | Standalone Native macOS 64-bit Intel Binary |
World Generation Performance Milestones (Tested on 12 Cores)
Beta 3.0 delivers unprecedented world generation speeds powered by the redesigned StageCache architecture and density router optimizations:
- Overworld Generation: Up to 515.99 chunks/second peak batched throughput (1024 chunks in 1.98 seconds — sub-2-second milestone achieved!).
- Nether Generation: 1,394.91 chunks/second (1024 chunks generated in 0.73s).
- The End Generation: 8,929.73 chunks/second (1024 chunks generated in 0.11s).
- Structure Reference Queries: Down from multiple milliseconds to 209 microseconds per chunk.
What's New in Beta 3.0
1. Breakthrough World Generation Optimizations
- StageCache Pipeline with FxBuildHasher: Chunk generation stages now leverage high-speed hashers and lock-free StageCache caching, eliminating cross-thread contention.
- Noise Density Router Acceleration: Dropped the Noise evaluation stage from 11.4ms down to 3.8ms (~66% speedup) through sample_wrapper density caching and hoisted vein sampling.
- Sky Air Skipping: Chunk noise population now skips expensive 3D density sampling for empty air columns above surface terrain.
- Lighting Engine Overhaul: Implemented VisitedBitSet, reusable
eset_queue, stride traversal optimizations, and stack-allocated carver arrays for zero-allocation propagation. - Structure Generator Mutex Elimination:
- Added cached bounding boxes in StructurePosition::new(), completely removing mutex locking on every bounding box intersection test.
- Upgraded StructureInstance::Reference(BlockBox, Arc<Mutex<...>>) to enable instant O(1) spatial pruning.
- O(1) Direct Array Feature Lookups: Replaced hash map lookups in ConfiguredFeaturesTable and PlacedFeaturesTable with direct array indexing via enum discriminants.
2. Minecraft 26.3 & Protocol 777 Compatibility
- Full Protocol 777 Support: Support for Minecraft 26.3 client connections, handshakes, and lifecycle state synchronization.
- Dynamic Registries (REGISTRY_V_26_3): Full serialization of 26.3 dynamic registries, including visual attributes (sky_color, og_color) and trim material descriptions.
- Registry & Packet Regenerations: Updated packet IDs, data component IDs, and sound effect IDs for 26.3.
- Block Network Expansion: Expanded BLOCK_NETWORK_MAX_BITS to 16 bits to seamlessly support hundreds of new block states.
3. New 26.3 Gameplay Content & Mechanics
- Straw Beds:
- Authentic sleeping mechanics with correct vertical Y-offset and player yaw orientation.
- Nether and End bed explosion mechanics and custom block drop tables.
- Shelf Mushrooms:
- 0.75 bouncy trampoline physics for players and entities.
- 50% fall damage reduction when landing on shelf mushrooms.
- Bone meal interaction for mushroom expansion.
- Poplar Trees, Wood & Vehicles:
- Full Poplar wood set: logs, wood, planks, stairs, slabs, fences, gates, doors, trapdoors, pressure plates, buttons, and signs.
- Native Poplar Boats and Poplar Chest Boats.
- Dedicated tree placement algorithms: PoplarFoliagePlacer, PoplarTrunkPlacer, and ShelfMushroomTreeDecorator.
- Red Shrubs:
- Authentic ground placement rules, survival checks on valid soil, and propagation.
- Wool Slabs & Wool Stairs:
- Placement and state conversion for all 16 wool color variants.
- Dedicated WoolSlabItem and WoolStairsItem handling.
- Cushions:
- Interactive cushion entities allowing players to sit and relax, with authentic item placement and break drops.
- Concrete Slabs & Concrete Stairs: Full implementation for all 16 concrete color variations.
- Explorer Maps & Structure Locating: Locate command and map generation support for new structures.
Quick Start
Pterodactyl & Existing Hosts (Recommended):
- Download server.jar and place it in your server directory.
- Ensure your startup command is set to standard Java execution:
�ash java -Xms1G -Xmx4G -jar server.jar - Start the server from your panel. The bootstrap JAR automatically downloads the matching native binary and handles console I/O seamlessly!
Standalone Windows:
- Download potato-windows-x86_64.exe.
- Rename it to potato.exe.
- Launch .\potato.exe in PowerShell or Command Prompt.
Standalone Linux:
- Download potato-linux-x86_64:
�ash curl -LO https://github.com/Flaxa-Technologies/potato-mc/releases/download/beta.3.0/potato-linux-x86_64 mv potato-linux-x86_64 potato chmod +x potato ./potato
Standalone macOS:
- Download matching native binary:
- For Apple Silicon (M1/M2/M3/M4): potato-macos-arm64
- For Intel Macs: potato-macos-x86_64
- Grant execution permission and run:
�ash chmod +x potato-macos-* ./potato-macos-*
Community & Collaboration
- Official Website: https://potatomc.flaxa.in/
- Join our Discord: Flaxa Studios Discord
PotatoMC Beta 2.0
Welcome to the Beta 2.0 release of PotatoMC! This release introduces major gameplay mechanics including the Totem of Undying, Core Redstone & Glass Transmission rules, Pistons & Sticky Pistons, Mace & Wind Charge Combat parity, Villager Trading, and record-breaking World Generation Performance.
Direct Downloads
| Platform / Host | Download Link | Description |
|---|---|---|
| Pterodactyl & Game Panels | server.jar | Universal Bootstrap JAR for Pterodactyl, Multicraft, and existing hosts |
| Windows (x86_64) | potato-windows-x86_64.exe | Standalone Windows 64-bit Server Binary |
| Linux (x86_64 MUSL) | potato-linux-x86_64 | Standalone Static Linux Binary (Ubuntu, Debian, Alpine, Arch, RHEL) |
Performance Benchmarks (Tested on 12 vCPU Cores)
PotatoMC delivers breakthrough generation throughput with the new StageCache pipeline:
- Overworld Throughput: Up to 427 chunks/second peak generation speed.
- Nether (Batched StageCache): 1,298.56 chunks/second (avg: 9.18ms | worst: 34.60ms | total: 0.79s — +9.4% speedup).
- The End (Batched StageCache): 6,633.22 chunks/second (avg: 1.79ms | worst: 13.98ms | total: 0.15s).
What's New in Beta 2.0
1. Totem of Undying Parity
- Lethal Damage Interception: Intercepts fatal damage in
LivingEntity::damage_with_contextbefore death events trigger (health - damage <= 0.0). - Hand Priority & Detection: Evaluates both Main Hand and Off Hand for
Item::TOTEM_OF_UNDYINGor items withDeathProtectiondata components (Main Hand checked first). - Damage Bypass Rules: Honors vanilla rules—void damage (
OUT_OF_WORLD) and/killproperly bypass totem protection. - Health & Effect Reset: Clamps health to exactly
1.0f(half heart) and wipes all active harmful status effects (Poison, Wither, Slowness, etc.) while preserving beneficial effects. - Vanilla Buff Application:
- Regeneration II: 900 ticks (45 seconds)
- Absorption II: 100 ticks (5 seconds)
- Fire Resistance I: 800 ticks (40 seconds)
- Animation, Audio & Inventory Sync:
- Broadcasts Entity Status Packet 35 (
EntityStatus::ProtectedFromDeath), triggering client floating totem screen animation, particle burst, anditem.totem.usesound. - Consumes 1 totem from the holding hand and synchronizes the slot via
player.sync_hand_slot, eliminating visual phantom totems on the client.
- Broadcasts Entity Status Packet 35 (
2. Core Redstone Wire & Transmission Rules
- Horizontal Strong Power Bugfix: Fixed an issue where redstone wire emitted strong power horizontally. Wire now strictly emits strong power downwards into the support block beneath it (
BlockDirection::Upquery) and0strong power horizontally, preventing signal leakage through solid walls. - Signal Decay: Accurate 0–15 power decay (decrements by 1 per block of wire traversed).
- Stepped Slope & Glass Rules:
- Directional stepped slope ascending/descending connectivity on solid opaque blocks.
- Transparent glass block rule: glass blocks do not conduct redstone power and do not sever/cut wire running over or climbing stepped blocks.
- Redstone Torch Parity:
- 1-tick delay inversion when the attached supporting block receives power.
- Standing and wall torches emit strong power (15) upwards and weak power (15) to adjacent horizontal neighbors.
3. Pistons & Sticky Pistons Mechanical Logic
- 12-Block Push Limit: Full
PistonStructureResolverport enforcing the vanilla 12-block maximum push line limit; lines of 13+ blocks are strictly rejected. - Immovable Block Enforcement: Halts push/pull when the line contains Bedrock, Obsidian, Crying Obsidian, Respawn Anchors, Reinforced Deepslate, or extended piston heads.
- Fragile Block Destruction: Fragile blocks (torches, flowers, redstone wire) are destroyed and dropped on push without consuming the 12-block push budget.
- Sticky Retraction Bugfix: Fixed North-facing retraction index bug (
to_index() == 2), ensuring sticky pistons pull the adjacent movable block properly across all orientations. - Slime & Honey Mechanics: Slime and Honey adhere to standard blocks but do not stick to each other.
4. Combat & Projectile Parity
- Point-Blank Self-Shot Bugfix: Fixed boundary clipping and raycast face detection for Ender Pearls and Wind Charges. Projectiles shot straight down at the ground hit the top block face instead of tunneling underground.
- Wind Charge Trigger Blocks: Wind charge bursts interact with trigger blocks (doors, trapdoors, fence gates, levers, buttons, bells, candles, and TNT) while zeroing direct block destruction.
- Mace Smash Attack: Falling > 1.5 blocks triggers tiered fall damage scaling (fall distance <= 3, 3 < d <= 8, d > 8), critical hit multiplier (1.5x), attacker fall damage negation on hit, and outward shockwave knockback.
- Mace Enchantments: Full support for Density, Breach (up to 60% armor reduction), and Wind Burst launch impulse.
5. Villager Trading & Village Simulation (TASK5)
- Villager Trading: Complete trading interface, trade generation, and tier leveling.
- Sign Parity: Fixed sign placement on normal terrain (dirt, grass block, path) and eliminated garbled text synchronization issues.
- Mob AI & Golem Spawning: Fixed pillager lockups when sighting distant targets, and resolved Iron Golem overspawning (30s panic cooldown, 10m gossip cooldown, 64x32x64 detection bounding box).
Quick Start
Pterodactyl & Existing Hosts (Recommended):
- Download
server.jarand place it in your server root. - Ensure your startup command is set to standard Java execution:
java -Xms1G -Xmx4G -jar server.jar
- Start the server from your panel. The bootstrap JAR will automatically detect your OS/architecture, download the matching native PotatoMC binary, and pipe console I/O seamlessly!
Standalone Windows:
- Download
potato-windows-x86_64.exeinto a new folder. - Rename it to
potato.exeif desired. - Run
.\potato.exein PowerShell or Command Prompt.
Standalone Linux:
- Download
potato-linux-x86_64:curl -LO https://github.com/Flaxa-Technologies/potato-mc/releases/download/beta.2.0/potato-linux-x86_64 mv potato-linux-x86_64 potato chmod +x potato ./potato
Community & Collaboration
- Official Website: https://potatomc.flaxa.in/
- Join our Discord: Flaxa Studios Discord
PotatoMC Beta 1.0
Welcome to the Beta 1.0 official release of PotatoMC - the next-generation, high-performance Minecraft server architecture written in Rust.
Direct Downloads
| Platform / Host | Download Link | Description |
|---|---|---|
| Pterodactyl & Game Panels | server.jar | Universal Bootstrap JAR for Pterodactyl, Multicraft, and existing hosts |
| Windows (x86_64) | potato-windows-x86_64.exe | Standalone Windows 64-bit Server Binary |
| Linux (x86_64 MUSL) | potato-linux-x86_64 | Standalone Static Linux Binary (Ubuntu, Debian, Alpine, Arch, RHEL) |
Quick Start
Pterodactyl & Existing Hosts (Recommended):
- Download
server.jarand place it in your server root. - Ensure your startup command is set to standard Java execution:
java -Xms1G -Xmx4G -jar server.jar
- Start the server from your panel. The bootstrap JAR will automatically detect your OS/architecture, download the matching native PotatoMC binary, and pipe console I/O seamlessly!
Standalone Windows:
- Download
potato-windows-x86_64.exeinto a new folder. - Rename it to
potato.exeif desired. - Run
.\potato.exein PowerShell or Command Prompt.
Standalone Linux:
- Download
potato-linux-x86_64:curl -LO https://github.com/Flaxa-Technologies/potato-mc/releases/download/beta.1.0/potato-linux-x86_64 mv potato-linux-x86_64 potato chmod +x potato ./potato
Key Highlights in Beta 1.0
- Panel Compatibility (
server.jar): Drop-inserver.jarenables instant hosting on Pterodactyl, Multicraft, PebbleHost, Bisect, and other standard Minecraft hosts without modifying panel images. - Native Rust Server Engine: Rock-solid 20.0 TPS with multithreaded execution and near-zero memory footprint (~30MB idle).
- Native Plugin Architecture (
potato-api): First-class support for loading compiled native Rust plugins (.dll/.so) with microsecond execution times. - Concurrent Chunk Streaming: Radial distance sorting and asynchronous world generation pipeline preventing terrain stalls.
- Standalone Executables: Direct binaries without zip extraction required.
Community & Collaboration
- Official Website: https://potatomc.flaxa.in/
- Join our Discord: Flaxa Studios Discord
