rewrite README based on the lead post on DB's MT Forum thread

master
Vanessa Dannenberg 2021-03-01 21:42:04 -05:00
parent f400b577b0
commit 982eb84489
2 changed files with 161 additions and 143 deletions

303
README.md
View File

@ -1,176 +1,195 @@
# Overview
Dreambuilder is my attempt to give the player pretty much everything they'll ever want to build with, and all the tools they should ever need to actually get the job done.
Dreambuilder is my attempt to give the player pretty much everything they'll ever want to build with, and all the tools they should ever need to actually get the job done. Of course, needs change, but this game should be a pretty good start!
This game is in use on my Creative server and on my Survival server, which also has a few extra mods installed for its specific needs. It should give you a pretty good idea nonetheless. Expect lag, as it's a significantly-developed multiplayer server, after all.
This game is in use on [url=https://forum.minetest.net/viewtopic.php?f=10&t=4057]my Creative server[/url] and on [url=https://forum.minetest.net/viewtopic.php?id=7017]my Survival server[/url], which also have extra mods installed for their specific needs (admin stuff mostly). They should give you a pretty good idea nonetheless. Expect lag, as they're both significantly-developed multiplayer servers, after all.
##  
##
# What's in it? What's changed from the default stuff?
* This game retains the light-colored user interface theme that was once present in old versions of minetest_game, because I don't like feeling like I live in a cave when I open a formspec/menu.
* The complete Plantlife Modpack along with More Trees and Vines mods add a huge amount of variation to your landscape (as a result, they will add mapgen lag). Active spawning of Horsetail ferns is disabled by default, and I've added papyrus growth on dirt/grass with leaves (using a copy of the default growth ABM).
* This game includes the Unified Inventory mod, which overrides the old default inventory to give you a much more powerful user interface, with crafting guide, bags, and more, and it also means that if you're using this game in creative mode, your stacks wil behave as if they're infinite, but can still have a proper stack count so that you can craft easily when needed.
* The default bones and TNT mods have been disabled. They're not exactly useful for building stuff with.
* Stu's split-limb player model replaces the default one.
* The default hotbar HUD holds 16 items instead of 8, taken from the top two rows of your inventory. The first 10 slots can be accessed by number keys 1-9 and 0, the rest via your mouse wheel. You can use `/hotbar ##` to change the number of slots from 1 to 23.
* The default lavacooling code has been supplanted by better, safer code from my Gloopblocks mod. That mod also provides stone/cobble --> mossy stone/cobble transformation in the presence of water.
* The complete Plantlife Modpack along with More Trees add a huge amount of variation to your landscape (as a result, they will add mapgen lag). Active spawning of Horsetail ferns is disabled by default, and I've added papyrus growth on dirt/grass with leaves (using a copy of the default growth ABM).
* This game includes RealBadAngel's Unified Inventory mod, which overrides minetest_game's default inventory to give you a much more powerful user interface, with crafting guide, bags, and much more.
* The default hotbar HUD holds 16 items instead of 8, taken from the top two rows of your inventory. You can use [icode]/hotbar ##[/icode] (8, 16, 24, or 32) to change the number of slots. Your setting is retained across restarts.
* The default lavacooling code has been supplanted by better, safer code from my Gloop Blocks mod. That mod also provides stone/cobble --> mossy stone/cobble transformation in the presence of water.
* An extensive selection of administration tools for single-player and server use are included, such as areas, maptools, worldedit, xban, and more.
* A few textures here and there are different.
* The mapgen won't spawn apples on default trees, nor will they appear on a sapling-grown default tree. Only the *real* apple trees supplied by the Moretrees mod will bear apples (both at mapgen time and sapling-grown). While on that subject, apples now use a 3d model instead of the plantlike version.
* A few textures here and there are different from their defaults.
* By way of Technic, all locked chests use a padlock in their recipes instead of a steel ingot.
Most other locked items work this way, too.
* The mapgen won't spawn apples on default trees, nor will they appear on a sapling-grown default tree. Only the *real* apple trees supplied by the More Trees mod will bear apples (both at mapgen time and sapling-grown). While on that subject, apples now use a 3d model instead of the plantlike version.
* A whole boatload of other mods have been added, which is where most of the content actually comes from. To be a little more specific, as of Feb. 2021, this game has a total of 209 mods (counting all of the various sub-mods that themselves are normally as part of some modpack, such as Mesecons, Home Decor, Roads, etc.) and supplies over 3000 items in the inventory/craft guide, and tens of thousands of unique items in total (counting everything that isn't displayed in the inventory)!
##  
# Okay, what else?
A whole boatload of other mods have been added, which is where most of the content actually comes from. To be a little more specific, as of February 2021, this game has a total of 208 mods (counting all of the various components that themselves come as part of some modpack, such as mesecons or homedecor) and supplies over 3100 items in the inventory/craft guide (there are tens of thousands of unique items in total, counting everything that isn't displayed in the inventory)! A mostly-complete list of mods is as follows:
A whole boatload of other mods have been added, which is where most of the content actually comes from. To be a little more specific, as of February 2021, this game has a total of 208 mods (counting all of the various components that themselves come as part of some modpack, such as mesecons or homedecor) and supplies over 3100 items in the inventory/craft guide (there are tens of thousands of unique items in total, counting everything that isn't displayed in the inventory)!
A complete list of mods is as follows:
* Ambience (TenPlus1; https://notabug.org/TenPlus1/ambience)
* Arrowboards (cheapie; https://cheapiesystems.com/git/arrowboards/)
* Bakedclay (TenPlus1; https://notabug.org/TenPlus1/bakedclay)
* Basic materials (https://gitlab.com/VanessaE/basic_materials)
* Basic signs (https://gitlab.com/VanessaE/basic_signs)
* Bedrock (Calinou; https://github.com/Calinou/bedrock)
* Bees (bas080; TenPlus1's fork; https://notabug.org/TenPlus1/bees)
* Biome lib (https://gitlab.com/VanessaE/biome_lib)
* Blox (my fork; https://gitlab.com/VanessaE/blox)
* Bobblocks (RabbiBob; no traps or mesecons support; https://github.com/minetest-mods/BobBlocks)
* Bonemeal (TenPlus1; https://notabug.org/TenPlus1/bonemeal)
* Caverealms lite (Ezhh; https://github.com/Ezhh/caverealms_lite)
* Cblocks (TenPlus1; https://notabug.org/TenPlus1/cblocks)
* Coloredwood (https://gitlab.com/VanessaE/coloredwood)
* Cottages (Sokomine; https://github.com/Sokomine/cottages)
* Currency (DanDuncombe; my fork; https://gitlab.com/VanessaE/currency)
* Datastorage (RealBadAngel; https://github.com/minetest-technic/datastorage)
* Digidisplay (cheapie; https://cheapiesystems.com/git/digidisplay/)
* Digilines (Jeija; https://github.com/minetest-mods/digilines)
* Digistuff (cheapie; https://cheapiesystems.com/git/digistuff/)
* Display blocks (jojoa1997; cheapie's "redo" fork, https://cheapiesystems.com/git/display_blocks_redo/)
* Dreambuilder hotbar (https://gitlab.com/VanessaE/dreambuilder_hotbar)
* Extra stairsplus (deezl)
* Facade (Tumeninodes; https://github.com/TumeniNodes/facade)
* Farming (TenPlus1's "redo" fork; https://notabug.org/TenPlus1/farming)
* Framedglass (RealBadAngel; https://github.com/minetest-mods/framedglass)
* Function delayer (HybridDog; https://github.com/HybridDog/function_delayer)
* Gardening (philipbenr; https://forum.minetest.net/viewtopic.php?t=6575)
* Gloopblocks (Nekogloop; my fork; https://gitlab.com/VanessaE/gloopblocks)
* Glooptest (Nekogloop; https://github.com/GloopMaster/glooptest; no treasure chests)
* Ilights (DanDuncombe; my fork; https://gitlab.com/VanessaE/ilights)
* Invsaw (cheapie; https://cheapiesystems.com/git/invsaw/)
* Item drop (PilzAdam; https://github.com/minetest-mods/item_drop)
* Jumping (Jeija; https://github.com/minetest-mods/jumping)
* Led marquee (https://gitlab.com/VanessaE/led_marquee)
* Locks (Sokomine; https://github.com/Sokomine/locks)
* Maptools (Calinou; https://github.com/minetest-mods/maptools)
* Memorandum (Mossmanikin; https://github.com/Mossmanikin/memorandum)
* Moreblocks (Calinou; https://github.com/minetest-mods/moreblocks)
* Moreores (Calinou; https://github.com/minetest-mods/moreores)
* Moretrees (https://gitlab.com/VanessaE/moretrees)
* Mymillwork (DonBatman; laza83's smooth meshes fork; https://github.com/laza83/mymillwork)
* New campfire (googol; my fork; https://gitlab.com/VanessaE/new_campfire)
* Nixie tubes (https://gitlab.com/VanessaE/nixie_tubes)
* Pipeworks (https://gitlab.com/VanessaE/pipeworks)
* Plasticbox (cheapie; https://cheapiesystems.com/git/plasticbox/)
* Player textures (Pilzadam; CWz's fork, with several default skins; )
* Prefab redo (DanDuncombe; cheapie's "redo" fork; https://cheapiesystems.com/git/prefab_redo/)
* Quartz (4Evergreen4; https://github.com/minetest-mods/quartz)
* Replacer (Sokomine; CWz's fork; https://github.com/ChaosWormz/replacer )
* Rgblightstone (cheapie; https://cheapiesystems.com/git/rgblightstone/)
* Signs lib (https://gitlab.com/VanessaE/signs_lib)
* Simple streetlights (https://gitlab.com/VanessaE/simple_streetlights)
* Solidcolor (cheapie; https://cheapiesystems.com/git/solidcolor/)
* Stained glass (doyousketch2; https://github.com/minetest-mods/stained_glass)
* Steel (Zeg9; my fork; https://gitlab.com/VanessaE/steel)
* Street signs (https://gitlab.com/VanessaE/street_signs)
* Titanium (Aqua; HybridDog's fork; https://github.com/HybridDog/titanium)
* Travelnet (Sokomine; https://github.com/Sokomine/travelnet)
* Ufos (Zeg9; https://github.com/Zeg9/minetest-ufos/)
* Unifiedbricks (wowiamdiamonds; https://github.com/minetest-mods/unifiedbricks)
* Unifieddyes (https://gitlab.com/VanessaE/unifieddyes)
* Unified inventory (RealBadAngel; https://github.com/minetest-mods/unified_inventory)
* Unifiedmesecons (cheapie; https://cheapiesystems.com/git/unifiedmesecons/)
* Windmill (Sokomine; https://github.com/Sokomine/windmill)
Modpacks:
* Castle-Modpack (philipbenr; minus the orbs; https://github.com/minetest-mods/castle)
* Cool trees modpack (runsy; https://github.com/runsy/cool_trees/)
* Homedecor modpack (https://gitlab.com/VanessaE/homedecor_modpack)
* Mesecons modpack (Jeija; https://github.com/minetest-mods/mesecons)
* Plantlife modpack (https://gitlab.com/VanessaE/plantlife_modpack)
* Roads modpack (cheapie; https://cheapiesystems.com/git/roads/)
* Technic modpack (RealBadAngel; https://github.com/minetest-mods/technic)
* Worldedit modpack (Uberi; https://github.com/Uberi/Minetest-WorldEdit)
Base game content imported from minetest_game:
* beds
* binoculars
* boats
* bucket
* butterflies
* carts
* creative
* default
* doors
* dungeon_loot
* dye
* env_sounds
* fire
* fireflies
* flowers
* game_commands
* give_initial_stuff
* map
* player_api
* screwdriver
* sfinv
* spawn
* stairs
* vessels
* walls
* weather
* wool
* xpanes
ambience redo
arrowboards
bakedclay
basic_materials
basic_signs
bedrock
bees
biome_lib
blox
bobblocks
bonemeal
caverealms_lite
cblocks
coloredwood
cottages
currency
datastorage
digidisplay
digilines
digistuff
display_blocks_redo
dreambuilder_hotbar
extra_stairsplus
facade
farming
framedglass
function_delayer
gardening
gloopblocks
glooptest
ilights
invsaw
item_drop
jumping
led_marquee
locks
maptools
memorandum
misc_overrides
moreblocks
moreores
moretrees
mymillwork
new_campfire
nixie_tubes
pipeworks
plasticbox
player_textures
prefab_redo
quartz
replacer
rgblightstone
signs_lib
simple_streetlights
solidcolor
stained_glass
street_signs
titanium
travelnet
unifiedbricks
unifieddyes
unified_inventory
unifiedmesecons
windmill
The full Home Decor modpack
The full Technic modpack
The full Plantlife modpack
Cheapie's Roads modpack
Zeg9's Steel modpack
Zeg9's UFO modpack
The full Mesecons modpack
Jeija's Jumping modpack
The full Worldedit modpack
### Your Inventory Display
This game, as previously mentioned, replaces the standard inventory with Unified Inventory, which almost defies description here. Unified Inventory includes waypoints, a crafting guide, set/go home buttons, set day/set night buttons, a full creative inventory on the right if you're playing in that mode - and you only have to click/tap the item once to get the it, instead of multiple clicks/drag and drop, a trash slot, a clear all inventory button, a search feature for the inventory, and more. Basically, you just need to use it a few times and you'll find yourself wondering how you ever got along with the standard inventory!
This game, as previously mentioned, replaces the standard inventory with Unified Inventory, which almost defies description here. Unified Inventory includes waypoints, a crafting guide, set/go home buttons, set day/set night buttons, a full creative inventory on the right if you're playing in that mode - and you only have to click/tap the item once to get the it, instead of multiple clicks/drag and drop, a trash slot, a clear all inventory button, a search feature for the inventory, and more. Basically, you just need to use it a few times and you'll find yourself wondering how you ever got along with the standard inventory!
### The Circular Saw
### The Table Saw
This game uses the More Blocks mod, which comes with the Stairsplus mod and more importantly, the Circular Saw mod by Sokomine and co. This mod replaces the traditional method of creating stairs, slabs, and the like: rather that crafting a stairs block by placing several of the material into your crafting grid, you must first craft a circular saw (really, a table saw), place that on the ground, and then use that to shape the material you had in mind. It can create dozens of shapes, including the standard stairs and slabs. Give it a try and see for yourself!
This game uses the More Blocks mod, which comes with Sokomine's Stairsplus, with its table saw component. This mod replaces the traditional method of creating stairs, slabs, and the like: rather that crafting a stairs block by placing several of the material into your crafting grid, you must first craft a table saw, place that on the ground, and then use that to shape the material you had in mind. It can create dozens of shapes, including the standard stairs and slabs. Give it a try and see for yourself!
### Land Ownership
This game uses ShadowNinja's areas mod for land protection, as well as cheapie's protector blocks. Of course, land protection is only useful if you're using this game on a public server.
This game uses ShadowNinja's areas mod for land protection, and also has cheapie's areasprotector, which supplies simple protection blocks, using areas as the backend. For more info on the areas mod, visit [url=https://forum.minetest.net/viewtopic.php?t=7239]the forum thread for it[/url]. cheapie's mod can be found on [url=https://cheapiesystems.com/git/areasprotector/]her git repository[/url]. Of course, these mods are only useful if you're running a multi-player server.
What's it look like? Screenshots or it didn't happen!
#### Protection blocks:
These are easy. Craft one, place it, and everything within 15m of it becomes yours immediately (if someone else doesn't own some of the land therein, of course). If you dig one of these, the area protection it created is removed; if you shift-dig, the protection is preserved, but the block is deleted, giving back some steel ingots if you're in survival mode, or nothing at all if in creative mode.
These are a few examples of what can be found or built with this game. Most of these screenshots came from my Creative server, since it has plenty of content just ripe for this purpose. :-)
#### Areas:
If you want fine control, use the areas mod's commands. There are three ways to select a region to protect:
**Option A:**
Just type `/area_pos set` and then punch two nodes that are diagonally opposite one another, so that they form a 3d box that fully encloses the area you want to claim. A black **`[1]`** or **`[2]`** will appear where you punched.
**Option B:**
1. Move to one corner, on the ground.
2. Type `/area_pos1` and press enter. A black **`[1]`** will appear.
3. Move to the other corner and go up a ways above your area - not too high though.
4. Type `/area_pos2` and press enter. A black **`[2]`** will appear.
**Option C:**
Just give actual coordinates to the `/area_xxx` commands, e.g.:
`/area_pos1 123,45,678 /area_pos2 987,654,321`
**Claim it:**
Once you've marked your area using one of the above methods, you must actually claim it. This is the step that actually protects it against vandalism and unauthorized access. Just type:
/protect some description here
By default, users may protect up to 3 zones with these commands, and each can be up to 50x100x50 meters in size, but this can be changed by plugging appropriate settings into your minetest.conf.
**Sublet it:**
Ok, you've claimed an area, and you want to let someone else build there. Simple. Set the coordinates of the box you want to let them build in, using the commands above (Options A, B, or C). Then do:
`/add_owner your_area# their_name description here`
For example, if you own area #123 and the other person's name is "Mike", and you want to sublet them some area called "Mike's home", you might do something like this:
`/add_owner 123 Mike Mikes Home`
You can add as many users as you like to your areas. You will need to issue one such command per user.
Wide angle view of Dopium Estate:
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/dopium-estate.png
Close-up view of the reactor on Dopium Estate:
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/dopium-reactor.png
KikaRz's House:
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/kikarz-estate.png
Just a tiny portion of CrazyGinger72's epic racetrack:
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/cg72-racetrack.png
CG72's skyscraper near the racetrack:
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/cg72-tower.png
A cubicle farm in another of CG72's office buildings:
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/cg72-office.png
A cave realm deep underground on one of my test worlds
http://daconcepts.com/vanessa/hobbies/minetest/screenshots/Dreambuilder/caverealm.png
## Dependencies:
This game requires Minetest 5.3.0 or later, and a corresponding copy of minetest_game. Anything too old will likely either crash, show nodes with the wrong shape or colors, throw nonsensical warnings/errors, or open up wormholes.
This game requires Minetest 5.4.0 or later.
## Hardware requirements:
This game defines a very large number of items and produces a well-detailed landscape, and so it requires a significant amount of resources compared to vanilla Minetest game. At least a 2 GHz dual core CPU and 2 GB free RAM are required for good performance. If you use my HDX texture pack, you'll need more RAM (at least 4 GB free recommended).
This game defines a very large number of items and produces a well-detailed landscape, and so it requires a significant amount of resources. At least a 2 GHz dual core CPU and 4 GB free RAM are required for good performance. If you use my HDX texture pack, you'll need a LOT more RAM.
This game is NOT intended for use on mobile devices.
This game is NOT recommended for use on mobile devices (though some newer devices, say from mid-2018 or later, may work okay).
## Download/Install:
...if you're reading this, you're either on the Dreambuilder Gitlab repo page, so clone it from there, or download the ZIP... or maybe you already have it. ;-)
## Download:
...if you're reading this, you're either on the Dreambuilder Gitlab repo page, so clone it from there, or download the ZIP from the button at the top of this repository page... or maybe you already have it. ;-)
Just rename the project folder to "dreambuilder_game", if necessary, and move it to your Minetest mods directory. Then select and enable it for the world you want to use it in. Depending on the condition of the world you are using, and for brand new maps, this game may take a minute or two to start, during which time you may see the hotbar and hand, all-grey window content where the world should be, or other odd-looking things. Just wait it out, it will eventually start and settle down.
## Install:
If you downloaded the zip, just extract it and rename the resultant directory to "dreambuilder_game", if necessary. If you're using the git repository, just clone it and keep the name as-is.
Move it to your Minetest games directory. When you start Minetest, you'll notice a little red "house" icon at the bottom of the main menu. Click that to select Dreambuilder, then create or select a world as you see fit.
Depending on the conditions of the world, this game may take as much as 2 minutes to start, during which time you may see the hotbar and hand, but all-grey window content where the world should be. Just wait it out, it will eventually start.
## License:
Each of the base mods in this game retains the standard license that its author has assigned, even if the license file is missing from the archive. All changes and any supplemental content made by me is WTFPL unless explicitly stated otherwise.
# Open Source Software
This game is open source, or at least as much so as I have control over. Since it started from the standard minetest_game distribution, you'll want to look at that. You can find it at its usual Github repository, here:
https://github.com/minetest/minetest_game
# Notes:
For best results, I recommend adding the following to your minetest.conf (perhaps to a secondary copy of that file that you only use when playing worlds with this game):
Each of the base mods in this game retains the standard licenses their original authors assigned, even if the license file is missing from the archive. For all of my Dreambuilder-specific changes and their related assets, LGPL 3.0 for code, CC-by-SA 4.0 for media and such.
## Open Source Software
This game is open source, or at least as much so as I have control over.

View File

@ -1 +0,0 @@
20210301-2049