ExchangeClone/README.md

263 lines
17 KiB
Markdown
Raw Normal View History

2023-05-13 21:13:22 +02:00
# ExchangeClone
2023-08-07 23:04:08 +02:00
Allows players to turn items into energy (stored in orbs), and energy from orbs into items. Supports all items in Minetest Game and MineClone 2! Includes other things from Equivalent Exchange (the MineCraft mod)
2023-06-23 23:02:22 +02:00
[GitHub repo](https://github.com/thepython10110/exchangeclone)
2023-05-13 21:13:22 +02:00
[Forum topic](https://forum.minetest.net/viewtopic.php?f=9&t=29473)
2023-05-13 21:22:32 +02:00
[ContentDB](https://content.minetest.net/packages/ThePython/exchangeclone)
[Direct download](https://github.com/ThePython10110/ExchangeClone/archive/refs/heads/main.zip)
2023-05-13 21:13:22 +02:00
Dependencies: Minetest Game or MineClone.
2021-12-30 23:09:15 +01:00
## Features
2023-08-07 23:04:08 +02:00
* Orb that holds energy (left click while holding it to show charge)
* Collector that collects energy from the sun
* Deconstructor that can turn items into energy
* Constructor that can create items from energy
* Philosopher's Stone
* Alchemical Coal, Mobius Fuel, and Aeternalis Fuel
* Dark and Red Matter Orbs, Blocks, tools, and armor
2021-12-30 23:09:15 +01:00
## Config
2023-08-07 22:56:29 +02:00
All energy values are in `energy.lua`. You can also change the speed at which the Energy Collector collects energy (default: 5 energy/second) in `minetest.conf` or the Minetest settings.
2023-03-27 00:19:19 +02:00
## New features added by ThePython10110
2023-08-07 22:56:29 +02:00
*More information in `changelog.txt`.*
2023-08-07 23:06:31 +02:00
2023-05-13 21:13:22 +02:00
* Support for MineClone
2023-08-07 23:04:08 +02:00
* COMPLETELY redone energy values (originally, you could convert a single diamond into a diamond block... incredibly OP).
2023-08-07 22:56:29 +02:00
* Shift-clicking works with the Constructor/Deconstructor/Collector (`listring`s)
* Fixed a bug where items could be placed in the output slot of the Element Constructor
* Added the ability to add energy values by group
* Damaged tools now give less energy (based on wear)
2023-05-23 16:53:45 +02:00
* Added Philosopher's Stone
2023-08-07 23:04:08 +02:00
* Aux1-right-click and aux1-sneak-right-click to increase and decrease transmutation range (0-4 nodes away from the node you are currently standing on)
* Right-click and sneak-right-click to transmute nodes in range (two different modes with minor differences)
* Left-click to open crafting table (MineClone only)
* Shift-left-click to open enchanting table (MineClone only)
* Ability to exchange resources by crafting (the Philosopher's Stone is always returned)
* Alchemical Coal, Mobius Fuel, and Aeternalis Fuel
2023-08-07 22:56:29 +02:00
* Dark and Red Matter Orbs, Blocks, tools, and armor
2023-05-13 21:13:22 +02:00
## Known issues:
2023-08-07 22:56:29 +02:00
* Dark and Red Matter armor look kind of terrible in MineClone. I might fix this eventually...
* There is an error reported in MineClone related to Red Matter armor setting health.
* In MineClone, it is impossible to heal past 20 health (10 hearts) without potions of healing (or the soul/life stones, which I haven't added yet)
* With a full set of red matter armor, you can almost instantly go back to 2000 health (1000 hearts), no matter what you health is, by removing one piece of red matter armor and putting it back on. I don't really know what to do about this, because of the previous issue. Normally, I would simply make 2000 the maximum health, and leave the player's health how it is, but that doesn't really work because the extra maximum health would be useless because it's unreachable.
* When items are inserted into the Energy Collector, Deconstructor, or Constructor with MineClone hoppers, it does not trigger the machines to start. I could probably fix this just by looking at the hopper API, so this could be fixed eventually.
* When machines are exploded, they (and the items inside) do not drop. I can't figure out why.
* Dark/Red matter shears will sometimes (randomly) be treated as normal shears when used by MineClone dispensers. This will not be fixed.
2023-08-07 22:56:29 +02:00
* Nodes destroyed by special abilities will not usually update surrounding nodes (so you may end up with floating gravel, flowers, torches, etc.). This will *probably* not be fixed, unless a change to Minetest makes it easier.
2023-05-13 21:20:16 +02:00
2023-05-13 21:13:22 +02:00
If you have a suggestion or notice a bug, visit the [GitHub issues page](https://github.com/thepython10110/exchangeclone/issues).
![MineClone Screenshot](screenshot.png)
![Minetest Game Screenshot](screenshot_mtg.png)
## Sources/license:
2023-09-12 16:46:59 +02:00
* Code: Forked and *heavily* modified from Enchant97's mod [Element Exchange](https://github.com/enchant97/minetest_element_exchange). Both this mod and Element Exchange are licenced under GPLv3+. Based on Equivalent Exchange and ProjectE, mods for MineCraft.
2023-08-07 22:56:29 +02:00
* Textures:
2023-09-12 16:46:59 +02:00
* Energy Collector, Element Deconstructor, Element Constructor: Directly from Element Exchange, GPLv3+.
* Exchange Orb: *Slightly* modified from Element Exchange (I just changed the color to white so it could change colors correctly)
2023-08-07 22:56:29 +02:00
* Alchemical Coal, Mobius Fuel, and Aeternalis Fuel: modified versions of MineClone's coal texture (CC-BY-SA-3.0).
* Dark and Red Matter Armor (and eventually Gem Armor): modified versions of diamond armor from 3D Armor (CC-BY-SA-3.0) and `mcl_armor` (CC-BY-SA-3.0).
* All other textures (and sounds): Created by me, inspired by Equivalent Exchange and licensed under CC-BY-SA-3.0.
2021-12-30 23:09:15 +01:00
2023-09-12 16:46:59 +02:00
# Changelog:
### 1.0.0
* Initial release
* New features:
* MineClone support, including (sort of) hoppers
* Added the ability to add items by group
* Shift-clicking (listrings)!
* Changes:
* Completely redone recipes, now includes all items.
* Tools' energy value now depends on wear.
* Bugfixes:
* Items can no longer be put in the Constructor's output slot.
* Honestly, I'm going to count the broken energy values as a bug...
### 2.0
* New features:
* Added a changelog (you're reading it now!)
* Added all items from Why (a MineClone modpack I made)
* Added Philosopher's Stone (these controls are now inaccurate; changed in 3.0)
* Left click to increase range (minimum = 0, maximum = 4).
* Shift+left click to decrease range.
* Aux1+left click to open enchanting table (MineClone only).
* Right click to transmute nodes in range (mode 1).
* Shift+right click to transmute nodes in range (mode 2, has some differences).
* Aux1+right click to open crafting table (MineClone only).
* Can use to craft coal into iron, mese into diamonds, etc.
* Changes:
* Changed version numbers from x.x.x to x.x.
* Changed the recipe for the Exchange Orb
* New recipe is a Philosopher's Stone in the middle, diamonds in the corners, and iron/steel ingots on the sides.
* Changed the energy values of tin, copper, and bronze in Minetest Game.
* Renamed images to reflect mod name change ("exchangeclone" instead of "ee" for Element Exchange)
* Deleted unnecessary "config.lua"
* Bugfixes:
* Ghost Blocks (from Why) are now worth 0 instead of 1 (to prevent infinite energy)
* Fixed stairs and slabs not working in Minetest Game
### 3.0 (the most interesting release so far)
* New features:
* Added Alchemical Coal, Mobius Fuel, Aeternalis Fuel, Dark Matter (blocks and orbs), and Red Matter (blocks and orbs)
* Added PESA (Personal Energy Storage Accessor)
* A single inventory slot in which an orb can be placed. Energy from the orb is used for special abilities.
* Added Dark and Red Matter tools
* Faster than any other tools (in unmodded MTG/MCL), each has an ability
* Special abilities that break nodes (as well as shearing) drop items directly on the player.
* Swords:
* Can damage all mobs within a radius (Red Matter sword can toggle between hostile/all mobs), costing 384 energy.
* Pickaxes:
* Has 3x1 modes (long, tall, and wide, all slightly slower)
* Can mine a full vein of ores, dropping items and experience on the player and costing 8 energy per node broken
* Axes:
* Can break all wood and leaves within a radius, costing 8 energy per node broken.
* Shovels:
* Can break all shovely nodes within a radius, costing 8 energy per node broken
* Can create paths in a radius, costing 4 energy per node
* Hoes:
* Breaks dirt incredibly quickly
* Has a 3x3 mode for digging dirt (slightly slower)
* Can till all dirt within a radius, costs 4 energy per node
* Hammers:
* Breaks pickaxey nodes in a 3x3 area
* Can break all pickaxey nodes within a radius, costing 8 energy per node broken
* Shears:
* More wool/mushrooms dropped when shearing, chance of cloning sheep/mooshrooms
* Can shear all shearable plants/cobwebs within a radius, costing 8 energy per node broken.
* Changes:
* Added a mod whitelist in `energy.lua`, any item from a mod NOT in the whitelist (`exchangeclone.whitelisted_mods`) will have an energy value of 0
* Orbs now show their energy on right click instead of left click
* Changed Philosopher's Stone controls to make everything more consistant
* The Energy Collector setting is now energy/second instead of second/energy to fit much higher costs than Element Exchange (default is 5 energy/s).
* Set gravel value to 1 to match sand/stone/dirt/etc (MineClone).
* Tuff, blackstone, and basalt are now transmutable (MineClone).
* A couple of minor transmutation changes (MineClone).
* Changed emerald value to 4096 (MineClone).
* Gold cannot be crafted into diamonds using the PS; it can now be crafted into emeralds and emeralds into diamonds (MineClone).
* The PS's enchanting table now is limited to 8-bookshelf enchantments to make it more balanced (MineClone).
* Fixed terracotta values (MineClone)
* Enchanted tools/armor are now worth the same amount as unenchanted tools/armor instead of twice as much (MineClone).
* Enchanted tools/armor cannot be created by the Constructor (MineClone).
* It is now impossible to get stacks of invalid sizes with the Constructor (>16 ender pearls or >1 pickaxe, for example)
* Bugfixes:
* Fixed freezing when attempting to deconstruct 0-energy items
* The Constructor, Deconstructor, and Energy Collector are now not unbreakable in MineClone (I really should test in survival).
* Copper blocks are now worth 4 times as much as copper ingots instead of 9 (MineClone).
* The Energy Collector now drops its contents when broken (MineClone)
* Fixed Exchange Orb energy value (forgot to change it after changing the recipe)
* Changed Constructor, Deconstructor, and Collector recipes and energy values to make them cheaper.
### 3.1
* Changes:
* Added new energy values from Why (and Why's new Minetest Game energy values)
* Bugfixes:
* Fixed crash based on PESA inventory movement
* Added `mcl_blackstone` to the mod whitelist
### 3.2
* Changes:
* Set MineClone mod namespace to exchangeclone
### 4.0
* New features:
* The "Features that I plan on adding eventually" list below
* Cooldowns for tool abilities to limit lag
* Red Katar (combination of sword, axe, hoe, and shears)
* Red Morningstar (combination of hammer, pickaxe, and shovel)
* Dark Matter Armor (full set gives immunity to lava/fire and drowning)
* Red Matter Armor (full set gives lava/fire/drowning immunity PLUS 2000 health, although you may want HUD Bars to see it)
* Added energy values for MineClone's new items.
* Changes:
* Changed the amount of damage done by Dark/Red Matter Sword special abilities (used to be `max_damage/distance`, now is `max_damage-distance`)
* A whole bunch of things that won't be noticible when playing, mostly code reorganization. It's *possible* that tools that mine multiple nodes at a time (hammer, pickaxe, hoe, katar, and morningstar) will be slightly less laggy
2023-09-12 16:46:59 +02:00
* Texture/sound license changed to CC-BY-SA-3.0 (because GPLv3+ isn't really meant as a media license).
* Bugfixes:
* Fixed an issue where MineClone dispensers could ONLY be used with Dark/Red Matter Shears (whoops).
### 4.1
* Bugfixes:
* Added energy values for new armor/tools
* Removed unnecessary chestplate image (not only is it unused, but I put it in the wrong folder for some reason)
### 4.2
* Bugfixes:
* Fixed a dependency error (thanks, @opfromthestart!)
### 4.3
2023-09-12 16:46:59 +02:00
* New features:
* New items from Why (flying sausage, useful green potatoes, etc.)
* Changes:
* The changelog now lives here!
* Exchange Orbs now change color based on the amount of energy (black->red->green->blue->magenta).
* Exchange Orbs now have a maximum energy of 51,200,000 (to match Equivalent Exchange's Klein Star Omegas).
2023-09-12 16:46:59 +02:00
* Water is now worth 0 instead of 1 (since it's infinite)
* Bugfixes:
* Exchange Orbs will now correctly display their energy value (I typed `orb` instead of `exchange_orb` in the energy value list)
### 5.0 (another *huge* release)
2023-09-12 16:46:59 +02:00
* New features:
* Transmutation Table(t)
* A much better (and cheaper) way to manage energy than the Constructor and Deconstructor.
* Teach items to the table by putting them in the Learn slot.
* Recreate learned items by clicking on them, then the "+1," "+5," "+10," and "+Stack" buttons to add them to the Output slots of the Table(t)
* The Table(t) will not show items that cost more energy than the player has.
* Charge orbs by putting them in the Charge slot.
* The Transmutation Tablet is the portable version of the Transmutation Table, and does exactly the same thing.
* All data (learned items, stored energy, etc.) is stored with the player, and will not be lost upon death or breaking/destroying the Transmutation Table(t).
* Mod developers can now add energy values to their own mods! Just set `exchangeclone_custom_energy` in the item/node definition.
* Alchemical Tome
* Feed this item to a Transmutation Table to teach it *all items* with energy. The Tome will NOT turn into energy, and will be completely lost.
* This is mostly so you can't just use it, then make a new one for no real cost and give it to someone else.
2023-09-12 16:46:59 +02:00
* Dark/Red Matter Furnaces
* Much faster than normal furnaces
* The Dark Matter Furnace has a 50% chance to duplicate when smelting ores (raw or otherwise).
* The Red Matter Furnace ALWAYS duplicates ores.
* Can be powered by placing next to an Energy Collector.
* Personal Energy Link
* An item copied from Project Expansion
* Allows you to use hoppers to get items into/out of your Personal Energy (MineClone)
* Upgraded Energy Collectors
* Energy Collector MK1-5
2023-09-12 16:46:59 +02:00
* The ability to upgrade dark/red matter tools to give them fortune, looting, fire aspect, and silk touch
* The ability to upgrade dark/red matter armor to give it thorns and frost walker
* Mind, Life, Body, and Soul Stones
* Custom Energy Values
* Mod developers can now set their own energy values by setting `exchangeclone_custom_energy` in the item/node definition.
* Added a [wiki](https://github.com/ThePython10110/ExchangeClone/wiki)!
* Changes
* Energy for Dark/Red Matter tool abilities (as well as the Transmutation Table) is no longer stored in an orb, but inside the player.
* The amount of energy you currently have stored is visible in the top right of the screen.
* Because of this, the PESA is now useless and deprecated. It will be removed after a few releases (so probably a couple months at least). Remove any Exchange Orbs from your personal storage.
* A lot of items (including DM/RM tools and armor) will not burn in lava in MineClone2.
* Energy Collectors now send their energy to the placer's personal energy by default.
* Placing an orb into an Energy Collector causes energy to go into the orb instead.
* If the Collector is near a DM/RM Furnace, all energy will be used to fuel the furnace.
* Red Matter Armor now sets your maximum health to 200 instead of 2000
* Energy Collectors now require less light to work (15->14)
* Exchange Orbs are now 18x better as fuel than they used to be
* DM/RM Shovels will now only create paths on blocks below air.
* Bugfixes:
* I must have skipped a row while going through MineClone's mod list. Several mods starting with `mcl_b` or `mcl_c` have been added to the whitelist.
* Removed unnecessary tool repair recipes from dark/red matter tools/armor
* Fixed a couple of armor texture issues in Minetest Game (though it still looks like diamond armor; 3D Armor doesn't support texture modifiers)
* The Red Katar is now actually craftable in Minetest Game (I just forgot that shears were only in MCL2)
2023-09-12 16:46:59 +02:00
### Features that I plan on adding eventually:
* Something that places nodes in a square (with varying range), possibly with a low energy cost
* Ability to smelt with the Philosopher's Stone and coal/charcoal (maybe?)
2023-09-12 16:46:59 +02:00
* Exchangeclone guidebook (maybe depend on doc mod?)
* As soon as Minetest 5.8 comes out, better textures for armor...
* Energy Condenser
* Divining Rods
* Rings (I'll probably add a new PESA-like item for holding rings)
2023-09-12 16:46:59 +02:00
* Archangel's Smite (though arrows will not track targets)
* Ring of Ignition
* Swiftwolf's Rending Gale (but without the force field)
2023-09-12 16:46:59 +02:00
* Zero Ring
* Harvest Band?
* Ring of Arcana (possibly without the Harvest Band)
* Gem Armor