Перейти к содержимому
Mineforgian

Torus

Electricity and machines without mods.

Загрузки
349
Подписчики
6
Обновлён
10 июня 2026 г.
Лицензия
GPL-3.0-only

Опубликован 13 февраля 2025 г.

Important!

This plugin is in experimental phase. I am still working on core features before I can polish everything and make it more user friendly. I also might change many things between versions so things can break.

What is Torus?

Torus brings electricity and custom modeled machines to your server without using mods or resource packs. It is inspired by plugins/mods like Slimefun, Immersive Engineering, BuildCraft, IndustrialCraft, etc.

Usage examples:

  • Generate electricity with solar panels, coal generators, and more
  • Improve your storage systems with item conduits (item filter support!)
  • Multiply ores by crushing them into dust
  • Automate mining entire chunks (similar to BuildCraft's quarry)
  • Pump liquids from underground with a pump
  • Automate cobblestone generators with block breakers (great for SkyBlock!)

List of all available content can be found here.

Many of these features will be toggleable to allow gameplay customization to your style.

Resource pack use is recommended, although not necessary, for easier item differentiation and some model improvements. You can download it here.

Getting started

To get structures or items, use /torus browse command. It will open a GUI where you can browse items through their categories. Simply left click an item to obtain it. If an item is a structure, right-click with it on the ground, after obtaining it, to place it. Size of each structure is visible when hovering over its item before placement.

Compatibility

Torus v0.5.2+ ModelEngine
Torus v0.6.0+ WorldGuard
Torus v0.6.3+ Lands, GriefPrevention

Documentation

As I am still working on core features, I did not write the documentation yet. I will slowly add things to docs as I polish the plugin over time. As of right now, you can find some machine guides on my Discord server.

Contribute

You can help me translate Torus to other languages on Crowdin.

Found a bug?

Report issues on GitHub or join the Discord server for support.

Ченджлог

0.7.0Бета26.1, 26.1.1, 26.1.2 · 10 июня 2026 г.

What's new?

  • Added Steam Turbine
  • You can now boil water in Fluid Tank
  • Generator is now a placeable structure
  • Added support for Residence (land-protection plugin) (thanks to @lim114514)
  • Turrets will now give knockback to entities it hits
  • Pressure Vents are now functional
  • Windmills now work faster when it's raining
  • Windmills now stop working if obstructed by blocks
  • Windmills now damage entities that stand in its way
  • Windmills now operate at full speed in flat worlds
  • Windmills now display "RPM" instead of "Efficiency"
  • Windmills do not generate RF anymore, but mechanical energy that generators convert to RF
  • Added Steam as a fluid type
  • Added Shaft item, used in crafting recipes
  • Removed Coal Generator
  • Redesigned Windmill, Pressure Vent, Fluid Pipe
  • Added sounds to Ore Crusher and Pressure Vent
  • Added recipes for Energy Cable, Windmill, Shaft
  • Structures that don't exist anymore, or an addon that provides them is not loaded, will now load as "Unknown Structures" that can be removed with hammer
  • Structure holograms now glow at night
  • Fixed Pressure Vent being in wrong category in /torus browse
  • Fixed Junction Box ignoring redstone input
  • Fixed unregistered structures corrupting "id_map.dat" file
  • Fixed model loader attempting to update non-existing files to 0.5.2 format
  • Fixed model spawning errors preventing other structures from loading
  • Fixed Wire Connectors loading wire positions as unsigned bytes
  • Fixed update checker running on the main thread
  • Fixed invisible Pumps on 1.21.8+
  • Renamed id_map.dat to structures.dat

Resource pack changes:

  • Added textures for Pressure Vent and Shaft
  • Fixed Iron Nugget using Iron Ingot as fallback texture

Read before upgrading from 0.6.3

Please backup your worlds and /plugins/Torus directory. I've done a lot of testing and things worked fine for me but just in case! Many things changed since the last update.

If there are any errors please let me know.

Thank you for the support so far! <3

0.6.3Бета1.21.9, 1.21.10, 1.21.11 · 20 февраля 2026 г.

What's new?

  • Recipes will now automatically export on the first run
  • Structure names, item names, lores, GUI titles and buttons, hologram texts can now be translated
  • GriefPrevention and Lands integrations
  • Custom model data customization
  • Added target selection for turrets with GUI editor
  • Added horizontal and vertical range customization for turrets
  • Changed how holograms are displayed to improve their visibility
  • Added integration_blacklist config option
  • Removed hammer requirement for breaking faucets
  • Removed /torus debug log_structure_ids
  • Fixed /torus give giving items to command executor instead of target player
  • Fixed structure placement not canceling interaction event causing base item to be placed as well sometimes
  • Fixed wires not spawning correctly in 1.21.1 because "scale" attribute was "generic.scale" in that version
  • Fixed middle click to pick up structure feature not working in 1.21.4+
  • Fixed 1x1 recipes not loading
  • Fixed update checker ignoring "allow_update_checks" config option

Let me know if there are any issues. Holograms are kinda weird now, but there is nothing I can do until Mojang decides to fix MC-265743

Thank you!

0.6.2Бета1.21.9, 1.21.10, 1.21.11 · 13 февраля 2026 г.

What's new?

  • Added Pressure Relief Vent
  • Added bucket fill sounds when using faucets
  • Added support for 1.21.1 - 1.21.3
  • Added toggleable notifications for Torus updates
  • Changed fluid tank model
  • /torus reload will reload structures too now
  • Automatic generation for structure and item configs
  • Added color code support for item lores
  • Added custom model data support for items
  • Renamed Item Cable into Item Conduit
  • Fixed invisible pumps on 1.21.8+
  • Fixed faucets requiring hammer to be broken
  • Fixed double event registration
  • Fixed /torus reload duplicating items in /torus browse

Place your fluid tanks again to update their input and output locations, otherwise there will be mismatch with their models.

"Middle click to pick up structures" feature does not work in 1.21.1-1.21.3 because some inventory interactions in creative mode worked differently before 1.21.4. I'll try to come up with something in the future.

Let me know if there are any issues. I lost some code due to hard disk failure but hopefully everything is fine.

0.6.1Бета1.21.5, 1.21.8, 1.21.11 · 4 февраля 2026 г.

What's new?

  • Added Junction Box (allows energy flow when powered with redstone)
  • Added Light Bulb
  • Cables/conduits/pipes/connectors can now be separated by right clicking them with a Screwdriver
  • Improved "highlight_networks" command with network ID information and a list of connected nodes
  • Added variable support to models
  • Models use .model files now instead of .yml
  • Fixed power banks taking energy from others power banks creating a loop
  • Fixed "interactive" property preventing adjacent structure placement
  • Fixed network mismatch for nodes

Note: If you are using custom models please back up the plugins/Torus/configs/torus folder because model_controller section from structures' configs will be deleted.

0.6.0Бета1.21.5, 1.21.8, 1.21.11 · 24 января 2026 г.

What's new?

  • Structure virtualization (structures can work even in unloaded chunks - configurable!)
  • Added vertical rotation for Block Breaker and Connector
  • Added bStats
  • New structure: Faucet
  • WorldGuard integration
  • Added new texture for Solar Generator top
  • Added "/torus debug highlight_network" command
  • Added "/torus debug report_stats" command
  • Added "Inventory is full!" indicator to Block Breaker
  • Removed "/torus debug inspect_network" command
  • Animated fluid level change in Fluid Tank and optimized the fluid display
  • Greatly optimized cable network building
  • Increased Fluid Tank's output limit to 1000mb
  • Optimized structure animations
  • Removed some debug console spam
  • Fixed structures trying to consume or import items from or to unloaded chunks
  • Fixed "argument type mismatch" errors
  • Fixed Wire Relay causing model unload errors
  • Fixed connector keeping "back=true" state even when it's not connected to anything
  • Fixed "_" and ":" characters breaking display entities models
  • Added missing permissions to debug commands

API changes:

  • Renamed Matter to Medium
  • Structure virtualization API
  • Direction.UP and Direction.DOWN is replaced with Pitch.UP and Pitch.DOWN for structure placement

Warning: I've made a lot of changes in this update related to model rendering and cable/structure connections. Please let me know if you encounter any issues. You can reach out on my Discord server, I'm active there.

0.5.3Бета1.21.5 · 7 января 2026 г.

What's new?

  • State driven structure models inspired by Minecraft's models
  • Multi-part models (multiple models at once for one structure part)
  • ModelEngine animations support
  • Customization for cables' and connector's models
  • Quarry now mines blocks with silk touch
  • Optimized model updates
  • Optimized turret head rotation
  • Removed export_model command
  • Fixed ore crusher's model again

API:

  • Added structure state API

Warning: If you are updating from 0.5.2 make a backup before installing, just in case! It should work fine.

0.5.2Бета1.21.5 · 25 декабря 2025 г.

What's new?

  • ModelEngine blueprints can now be used as structure models!
  • Combined parts "blade_1" and "blade_2" into "blades" for Windmill
  • Changed model config format (your model files will automatically update)

API news:

  • ResourceLocation now provides Resource (which contains both File and InputStream) instead of InputStream
  • Added abstraction layer for model parts
  • Added RendererConfigLoader registration (for loading models from custom providers)
  • Added PlayerStructureInteractEvent event

Important: ModelEngine models can not be used for animated parts of machines YET! I'm working on state-based and multipart models and animation controllers; once that is done, ModelEngine can be used for all machine parts.

0.5.1Бета1.21.5 · 23 декабря 2025 г.

What's new?

  • Item configuration is now loaded from files (item type, display name, lore, categories)
  • Renamed "packs" directory to "configs"
  • Moved config.yml to configs folder
  • Added "/torus export_preset" command
  • BlockDisplay entities too can now be used for models
  • Fixed structure-belonging barrier blocks disappearing when rapidly breaking them
  • Corrected End Rod's rotation on Windmill

API news:

  • Introducing Addons API!
  • Added lifecycle system (for registering custom structures, items and recipes)
  • Added PlayerStructurePrePlaceEvent, PlayerStructurePlaceEvent, PlayerStructureBreakEvent
  • Added ResourceLocation and Container classes for easier resource location specification

If you edited configs:
If upgrading from the previous version then all structures should work fine, however your old configs will not be loaded because they are expected at new locations. I suggest completely removing Torus folder (in /plugins), while keeping the backup, and letting the plugin generate new config files. After that, manually restore your custom configs.

If you encounter any issues please report them on my Discord server, or on Github.

Комментарии

Загружаем…