
478
8
🚀 FreeCarts v1.7 Changelog
release5 апреля 2026 г.✨ New Features & Improvements
- Localization: Added Simplified Chinese translation support (Special thanks to SnowCutieOwO!).
- Advanced Upgrade Mechanics: The
amountfield for Cart, Garage, and Garage-Slot upgrades now supports a value of "0" with 'material' set to an item/block.- Note: This allows you to require a specific item in a player's inventory without consuming it during the upgrade.
- Custom Item Support: Materials for all upgrade categories now fully support Custom Model Data, allowing for deeper integration with custom resource packs.
- Refueling Overhaul:
- Introduced a sleek New Refueling Menu.
- Fuel cans can now be directly filled at fuel stations using glass bottles. The refill cost can be configured in the
config.yml. - Streamlined the process by removing the old fuel-can menu; you can now right-click a cart with a fuel can to refuel instantly.
- GeyserMC Compatibility: Updated the Bedrock example pack to align with the latest GeyserMC format versions.
🛠️ Bug Fixes & Logic Tweaks
- Bedrock Support: Fixed an issue where freshly placed Fuel Stations wouldn't display "fake blocks" for Bedrock players until a they interact with it or reconnect.
- GUI Fix: Fixed a bug where paint colors from the variants menu wouldn't load properly if the customization menu hadn't been opened first.
- Feedback & Messaging: The Repair Kit message now correctly displays the updated health value upon use.
- Exploit Fix: Blocked the vanilla crafting recipe that allowed Fuel Cans (Honey Bottles) to be turned into 3x Sugar.
Steps to Update the Plugin:
- Download the new plugin ".jar" file.
- Replace the existing file in your "/plugins/" folder with the newly downloaded file.
- Delete the "config.yml" file and the contents of the "/lang/" folder.
- Start the server to allow the plugin generate a new "config.yml" and fresh language files.
- Configure the "config.yml" as desired and restart the server.
FreeCarts 1.6: Nitro Overhaul & Bedrock fixes
release22 марта 2026 г.FreeCarts
Version 1.6 - Major bug fixes related to maximum speed and upgrades, Better Bedrock compatibility, Action Bar Overhaul & Nitro Status Display
This update introduces full Bedrock (Geyser/Floodgate) compatibility improvements, a completely rearchitected action bar system, and a live nitro status display.
🎮 Player Summary (Non-Developer Audience)
- You will now visibly notice the speed differences between "un-upgraded", "max-upgraded", and "max-upgraded + nitro-engaged carts".
- Fuelstation's block display models now compatible with Custom worlds from Multiverse-Core and similar plugins.
- Bedrock players now see the fuel indicator correctly instead of a blank character.
- The action bar now shows fuel, health, and nitro status as separate indicators, each toggleable independently from the cart GUI menu.
- The nitro indicator shows exactly how many seconds of boost remain while active, a green tick when ready to use, and a countdown while cooling down — no more guessing when you can fire it again.
- You can now use decimal values for fuelConsumptionRate in the config
🛠 Update Changelog (For Developers/Admins)
🛠 Update Changelog (For Developers/Admins)
Fix - critical issues within the upgrade system and cart speed mechanics
- Fixed Engine & Nitro Upgrades Not Scaling Top Speed: Previously, cart movement was strictly hard-capped by the config's maxSpeed, meaning high-level Engine and Nitro upgrades were throttled and provided no noticeable top-speed benefits. The plugin now dynamically scales the internal maximum speed limits based on your cart's upgrade multiplier, allowing fully upgraded carts to reach their true potential.
- Fixed Vanilla Server Speed Throttling: Bypassed Spigot's internal minecart velocity limits (which default to 0.4 blocks/tick) for player-driven carts by calculating and applying a safe, dynamic maxSpeed ceiling to active vehicles. Unoccupied carts correctly retain the config's base maxSpeed limits to prevent runaway vehicles from breaking physics.
- Fixed Base Level (1) Upgrade Stat Bonuses: Fixed an oversight where newly placed, un-upgraded carts (Engine Level 1, Brake Level 1) were incorrectly receiving an immediate +15% speed and +25% brake bonus. Level 1 components now act as true baselines (1.0x multiplier), and upgrades properly scale starting at Level 2.
Fixed - critical issues within the FuelStation system and model mechanics.
- Fixed fuel station models not spawning in Multiverse custom worlds by injecting execute in
run into summon commands - Fixed getDimensionKey() helper to use World#getEnvironment() instead of folder name, supporting custom level-name in server.properties
- Fixed entity fallback lookup always searching the overworld by including world name in the location key (world,x,y,z)
- Fixed two Thread.sleep(50) calls blocking the main server thread on every station spawn
- Fixed fuel stations in Multiverse worlds silently lost on startup due to world load race condition, resolved via ServerLoadEvent retry system
More Bedrock (Geyser) Compatibility
- Fixed Fuel Level Icon in Action bar Displays Not Rendering on Bedrock: The ⛽ emoji is outside Bedrock's font atlas and rendered as a blank character. Bedrock players now receive ♨ as a fallback icon via a cached detection system.
- Added Bedrock Player Cache: Geyser/Floodgate detection is now performed once per player session on join and stored in a HashSet.
Better Backward Compatibility
- Fixed Fuel Station Version Gate Blocking Mechanics on Pre-1.19.4 Servers: Fuel station hitbox, collision, refueling, and explosion mechanics no longer require 1.19.4+. The version gate now only blocks Block Display entity models. Pre-1.19.4 servers render fuel stations using the same sendBlockChange() fake block system already used for Bedrock players.
Action Bar System Rearchitecture
- Extracted Action Bar Logic into Dedicated ActionBarHandler Class: Fuel and health display logic has been moved out of FuelHandler into a new ActionBarHandler, which owns the render task, Bedrock cache, per-stat toggle state, and stat registration pipeline.
- Added Expandable CartStat Interface: Each action bar segment (fuel, health, nitro, etc.) is now an independently registered stat implementing CartStat. Adding new stats in the future requires no changes to existing classes.
- Fixed Health Display Being Hidden by Fuel Toggle: Previously, the single hide_fuel_actionbar PDC key suppressed both fuel and health display together. Each stat now has its own independent PDC toggle key (hide_stat_fuel, hide_stat_health, etc.).
- Moved Stat Registration Out of Main Class: FuelStat, HealthStat, and NitroStat are defined as named inner classes inside ActionBarHandler, keeping the code clean.
Action Bar Settings Menu
- Replaced Single Toggle Button with Dedicated Submenu: The action bar toggle in the cart GUI is now a submenu.
- Each Stat Has Its Own Toggle Button: Buttons display as green concrete (enabled) or red concrete (disabled).
New Nitro Status Display
- Added Live Nitro Action Bar Stat: The nitro segment displays remaining active time in seconds while burning, a green tick when ready to engage, and a red remaining cooldown seconds while cooling down.
- Added nitroActiveEnd Tracking: CartUpgradeHandler now tracks the nitro active end timestamp alongside the existing cooldown end timestamp, enabling accurate remaining-time calculations.
Fuel consumption enchancements
- Changed fuelConsumptionRate from int to double to support decimal values like 0.2, 0.5
- Added a fractional accumulator map inside the fuel consumption runnable so decimal rates drain correctly without precision loss.
Steps to Update the Plugin:
- Download the new plugin ".jar" file.
- Replace the existing file in your "/plugins/" folder with the newly downloaded file.
- [MUST] Delete the "config.yml" file and the contents of the "/lang/" folder.
- Start the server to allow the plugin generate a new "config.yml" and fresh language files.
- Configure the "config.yml" as desired and restart the server.
Bedrock / GeyserMC Support
release9 марта 2026 г.FreeCarts v1.5 - Bedrock / GeyserMC Support
Update Changelog:
- This update focuses on cross-platform compatibility between Java and Bedrock (Geyser/Floodgate) clients.
- The Fuel Can item has been changed from a Player Head with a custom texture to a Honey Bottle. Existing fuel cans will continue to work, but new ones will be issued as Honey Bottles going forward.
- Added two configurable visual blocks for fuel stations in config.yml, since Bedrock does not support Block Display entities. (Note: Fuel stations use Bukkit's sendBlockChange() to send per-player fake block packets, which Geyser automatically translates into Bedrock's UpdateBlockPacket. These fake blocks are fully configurable in config.yml. Java players are completely unaffected and will continue to see the fuel station's Block Display model as usual.)
- Added an example resource pack for GeyserMC.
- Fuel Cans can now be consumed by players. When consumed, the following effects are applied: Poison II for 10 seconds, Nausea for 15 seconds, and Weakness II for 20 seconds.
- Dismount key has been assigned to the SPACE BAR for Bedrock players.
- Nitro Engage key has been assigned to Left Click (Attack) for Bedrock players.
- Key binds remain unchanged for Java players.
- From version 1.5 onwards, the plugin no longer bundles example resource packs with the JAR file. They are instead provided as separate download links on the plugin page.
Steps to Update the Plugin:
- Download the plugin ".jar" file.
- Replace the existing file in your "/plugins/" folder with the downloaded file.
- Delete the "config.yml" file and the contents of the "/lang/" folder.
- Start the server to let the plugin generate a new "config.yml" and language files.
- Configure "config.yml" as desired and restart the server.
Setting Up GeyserMC:
- FreeCarts automatically detects Floodgate and GeyserMC on your server.
- Works out of the box with Geyser installed as a Spigot plugin.
- For Velocity/BungeeCord networks, Floodgate must be installed on each backend Spigot server in addition to Geyser on the proxy.
- To use the example GeyserMC resource pack provided, extract the downloaded archive — it contains two files :
- Place "geyser_mappings.json" inside "\plugins\Geyser-Spigot\custom_mappings"
- Place "Freecarts_GeyserPack.mcpack" inside "\plugins\Geyser-Spigot\packs"
- Restart the server after placing both files.
Garage menu fix for Non-English Languages
release23 декабря 2025 г.🔧 FreeCarts v1.4 - Multi-Language Garage Fix
🐛 Bug Fixes
Fixed garage menu handling for multi-language support: Resolved an issue where the garage inventory click handler wasn't properly detecting garage menus when using non-English languages. The plugin now correctly identifies garage menus regardless of the selected language (English, German, Tamil, etc.).
🌍 Affected Languages
This fix improves functionality for all supported languages: English (en_us) German (de_de) Tamil (ta_in)
📝 Technical Details
- Improved garage menu detection logic to use menu type tracking instead of title matching
- Enhanced reliability when interacting with garage inventories across different languages
- No configuration changes required - the fix is automatic
📥 Installation
Simply replace your existing FreeCarts jar file with this version and restart your server. All existing data and configurations will be preserved.
Now supports 1.21.11
release22 декабря 2025 г.-
Support added for **1.21.11** -
Minor bug fixes related to cart damage and health system
Совместимость
Ссылки
Создатели
Детали
Лицензия:MIT
Опубликован:6 месяцев назад
Обновлён:4 недели назад
