mirror of
https://git.minetest.org/BuckarooBanzay/digibuilder.git
synced 2024-12-13 07:53:17 +01:00
readme
This commit is contained in:
BuckarooBanzay
parent
4040119fba
commit
7da9603d13
170
readme.md
170
readme.md
@ -1,171 +1,7 @@
|
|||||||
Minetest jumpdrive
|
Minetest digibuilder
|
||||||
======
|
======
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
A simple [Jumpdrive](https://en.wikipedia.org/wiki/Jump_drive) for minetest
|
State: **WIP**
|
||||||
|
|
||||||
Take your buildings with you on your journey
|
|
||||||
|
|
||||||
* Github: [https://github.com/thomasrudin-mt/jumpdrive](https://github.com/thomasrudin-mt/jumpdrive)
|
|
||||||
* Forum topic: [https://forum.minetest.net/viewtopic.php?f=9&t=20073](https://forum.minetest.net/viewtopic.php?f=9&t=20073)
|
|
||||||
|
|
||||||
# Operation
|
|
||||||
|
|
||||||
* Place a 'jumpdrive:engine' into the center of your creation.
|
|
||||||
* Connect the engine to a technic HV network
|
|
||||||
* Let the engine charge
|
|
||||||
* Choose your target coordinates (should be air or ignore blocks)
|
|
||||||
* Select your cube-radius
|
|
||||||
* Click "show" and check the green (source) and red (target) destination markers if everything is in range
|
|
||||||
* Click "jump"
|
|
||||||
|
|
||||||
# Compatibility
|
|
||||||
|
|
||||||
Optional dependencies:
|
|
||||||
* Mesecon interaction (execute jump on signal)
|
|
||||||
* Technic rechargeable (HV)
|
|
||||||
* Travelnet box (gets rewired after jump)
|
|
||||||
* Elevator (on_place gets called after jump)
|
|
||||||
* Locator (gets removed and added after each jump)
|
|
||||||
* Pipeworks teleport tubes (with a patch to pipeworks)
|
|
||||||
* Beds (thx to @tuedel)
|
|
||||||
* Ropes (thx to @tuedel)
|
|
||||||
* Mission-wand as coordinate bookmark (thx to @SwissalpS)
|
|
||||||
* Areas
|
|
||||||
* Drawers
|
|
||||||
|
|
||||||
# Fuel
|
|
||||||
|
|
||||||
The engine can be connected to a technic HV network or fuelled with power items.
|
|
||||||
Power items are one of the following
|
|
||||||
* `default:mese_crystal_fragment`
|
|
||||||
* `default:mese_crystal`
|
|
||||||
* `default:mese`
|
|
||||||
|
|
||||||
# Energy requirements
|
|
||||||
|
|
||||||
The energy requirements formula looks like this: **10 x radius x distance**
|
|
||||||
|
|
||||||
For example:
|
|
||||||
* Distance: 100 blocks
|
|
||||||
* Radius: 5 blocks
|
|
||||||
* Required energy: 10 x 5 x 100 = 5000
|
|
||||||
|
|
||||||
# Upgrades
|
|
||||||
|
|
||||||
If the `technic` mod is installed the following items can be used in the upgrade slot:
|
|
||||||
* `technic:red_energy_crystal` increases power storage
|
|
||||||
* `technic:green_energy_crystal` increases power storage
|
|
||||||
* `technic:blue_energy_crystal` increases power storage
|
|
||||||
* `technic:control_logic_unit` increases power recharge rate
|
|
||||||
|
|
||||||
# Protection
|
|
||||||
|
|
||||||
The source and destination areas are checked for protection so you can't remove and jump into someone else's buildings.
|
|
||||||
|
|
||||||
|
|
||||||
# Screenshots
|
|
||||||
|
|
||||||
Interface:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# Advanced operation
|
|
||||||
|
|
||||||
## Coordinate bookmarking
|
|
||||||
|
|
||||||
You can place empty books into the drive inventory and write the coordinates to it with the "Write to book" button
|
|
||||||
The "Read from book" reads the coordinates from the next book in the inventory
|
|
||||||
|
|
||||||
## Diglines
|
|
||||||
|
|
||||||
* See: [Digilines](doc/digiline.md)
|
|
||||||
|
|
||||||
# Settings
|
|
||||||
|
|
||||||
Settings in minetest.conf:
|
|
||||||
|
|
||||||
* **jumpdrive.max_radius** max radius of the jumpdrive (default: *15*)
|
|
||||||
* **jumpdrive.max_area_radius** max radius of the area jumpdrive (default: *25*)
|
|
||||||
* **jumpdrive.powerstorage** power storage of the drive (default: *1000000*)
|
|
||||||
* **jumpdrive.power_requirement** power requirement for chargin (default: *2500*)
|
|
||||||
|
|
||||||
# Lua api
|
|
||||||
|
|
||||||
## Preflight check
|
|
||||||
|
|
||||||
The preflight check can be overriden to execute additional checks:
|
|
||||||
|
|
||||||
```lua
|
|
||||||
jumpdrive.preflight_check = function(source, destination, radius, player)
|
|
||||||
-- check for height limit, only space travel allowed
|
|
||||||
if destination.y < 1000 then
|
|
||||||
return { success=false, message="Atmospheric travel not allowed!" }
|
|
||||||
end
|
|
||||||
|
|
||||||
-- everything ok
|
|
||||||
return { success=true }
|
|
||||||
end
|
|
||||||
```
|
|
||||||
|
|
||||||
## Fuel calc
|
|
||||||
|
|
||||||
The default fuel calc can be overwritten by a depending mod:
|
|
||||||
|
|
||||||
```lua
|
|
||||||
-- calculates the power requirements for a jump
|
|
||||||
jumpdrive.calculate_power = function(radius, distance, sourcePos, targetPos)
|
|
||||||
return 10 * distance * radius
|
|
||||||
end
|
|
||||||
```
|
|
||||||
|
|
||||||
# Sources
|
|
||||||
|
|
||||||
* jumprive_engine.ogg: https://freesound.org/people/kaboose102/sounds/340257/
|
|
||||||
|
|
||||||
# Contributors
|
|
||||||
|
|
||||||
* @tuedel
|
|
||||||
* @SwissalpS
|
|
||||||
* @Panquesito7
|
|
||||||
* @OgelGames
|
|
||||||
* @S-S-X
|
|
||||||
|
|
||||||
# History
|
|
||||||
|
|
||||||
## Next
|
|
||||||
* optional technic mod
|
|
||||||
* upgrade slots
|
|
||||||
|
|
||||||
## 2.0
|
|
||||||
|
|
||||||
* various fixes and optimizations
|
|
||||||
* Fleetcontroller
|
|
||||||
* Digiline interface
|
|
||||||
* mod.conf (minetest >= 5.0)
|
|
||||||
* Beds,ropes,missions compatibility
|
|
||||||
* calculate_power() override
|
|
||||||
* overlap check
|
|
||||||
* No fuel consumption if creative
|
|
||||||
* Protection checks for source and destination
|
|
||||||
* preflight check with custom override
|
|
||||||
* Settings in minetest.conf
|
|
||||||
* vacuum compatibility (jump into vacuum with air filled vessel)
|
|
||||||
|
|
||||||
## 1.1
|
|
||||||
|
|
||||||
* improved performance
|
|
||||||
* Documentation
|
|
||||||
* Removed complicated cascade function
|
|
||||||
|
|
||||||
## 1.0
|
|
||||||
|
|
||||||
* Initial version
|
|
||||||
* Cascade operation (with issues)
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user