forked from echurchill/WellWorld
-
Notifications
You must be signed in to change notification settings - Fork 0
/
wellworld_description.txt
128 lines (97 loc) · 8.66 KB
/
wellworld_description.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
== **WellWorld** ==
===== //Version 1.00// =====
,,//(sometimes there is a delay in getting the new version of the plugin through the approval process, if the above version isn't available check back in an hour or so)//,,
//(This plug in doesn't take advantage of the new "taller" chunks yet but it should run fine in the newest Bukkit)//
Now includes well generators from Codename_B and Khyperia, thx
Latest changes...
* v1.00 1.8.8 Minecraft/Spigot happy
* v0.83 1.2.3-R0.2 Happy and Fixed a few string and permission issues
* v0.82 1.2.3 R0 Happy, since Bukkit doesn't support taller generated heights yet we are still stuck at 127, sorry
=== The story ===
Imagine waking up one day, in Minecraft, and finding yourself surrounded by walls. These walls are not the ones your friends griefed you with but ones that reach all the way to the sky. You are trapped, surrounded... all alone... or are you? Did you just see somebody poking their head out of one of those little doors WAY up there? I wonder if they will be friendly?
{{http://dev.bukkit.org/media/images/37/78/Where_did_those_walls_come_from.jpg|Waking up on WellWorld}}
=== The backstory ===
During my recent break from [[http://dev.bukkit.org/server-mods/cityworld/|CityWorld]], I have been going over my collection of world generator attempts. Most of them are pretty darn unexciting.. or too weird to do anything with. In addition I have been surfing to see what my fellow world creators have been up to. There are a number of cool ideas out there but they all suffer ([[http://dev.bukkit.org/server-mods/cityworld/|CityWorld ]] included) from one little problem.. eventually the generator repeats itself and the world gets boring. It got me thinking of old notion: The WellWorld.
The mod concept is based on a science fiction series by Jack L. Chalker called [[http://en.wikipedia.org/wiki/Well_World|WellWorld]]? In it the "world" divided up into a series of hexagonal regions, each with their wildly different environments for different alien civilizations... It is part zoo and part UN. A good read if you are into grand science fiction.
Anyway, in addition to the "boring" problem, one of the most difficult things about creating a world generator is making it capable of creating wildly different environments, alas all of those different environments cannot be next to each other or they look weird. Thus we have to create smoothing tech to allow deserts gradually turn into swamps and then into mountains and then into seas.
It dawned on me that dividing the world into large square regions (this is Minecraft after all) with walls of obsidian (or bedrock if you want to be "hard core"). Then populate those regions with wildly different environments. Heck, the Nether (big box with a roof) could be next door to a region that is completely filled with water, next to a crystal world made of glass ground with thin-glass trees. :-)
Poof... both the smoothing and boring problems goes away.
{{http://dev.bukkit.org/media/images/37/84/Four_Corners.jpg|From way above}}
p.s. Not all those little doors up in the wall lead next door.. some are there just to confuse you. One other warning: Creepers (that little green speck in the wall above) love spawning in those doors. Fun eh?
----
=== Issues and possible future fixes ===
* Multiverse – In the long run it might be possible to have this work directly with “real” world generators but for now each generator must be compiled into the WellWorld plugin.
* Biomes – Right now, WellWorld doesn’t attempt to do anything with Biomes. Ideally each well could have its own.
* Physics – Each Well shares lighting and time-of-day with each other. This makes fully enclosed wells like caverns brighter than they should be.
* No built in commands – Like with CityWorld, I have kept this plugin simple... but I plan to impliment a few in the near future
* Needs more variety – Right now there are about a dozen generators enabled. Like with world generators themselves, it is pretty easy to add new well generators to WellWorld. In fact during the creation of WellWorld I ported some generators from [[http://forums.bukkit.org/threads/codename_bs-list-of-plugins-under-50-lines-of-code-aka-the-under-50-challenge.33264/|s1mpl3x]] and [[https://github.com/Dinnerbone/BukkitFullOfMoon|Dinnerbone]] but since I don’t have their permission, I have left them disabled. Ok, that's not entirely true, I am including one generator loosely based on BukkitFullOfMoon
=== Heads up! ===
Like CityWorld, this plugin really "tests" MineCraft/Bukkit when it comes to complex worlds. In fact when you spawn/teleport into the world for the first time (or some wildly new location) it takes a while for all of the blocks to generate. This is especially obvious if you are flying around. Once the blocks are generated though everything works just fine. What I recommend is take a tour of your world and just walk/fly up to each "uninitialized chunk" until everything shows up.
From time to time in the Moon wells, the craters will do odd things. It seems that the block and chunk populators get out of sync and cause a glitch. When this happens, you will see a partially created crater and building in it (or digging) will cause blocks to disappear/appear on their own. I am still trying to understand this one but it doesn't seem related to WellWorld as it shows up in Dinnerbone's BukkitFullOfMoon as well.
----
=== Installing ===
This is purely a world generator, it does not add permissions or many options to configure. If you need permissions, teleportation or world management support there are plenty of plugins that will do that for you. The Bukkit plugin ecosystem does not need more of those puppies. This is JUST A WORLD GENERATOR. :-)
To install it you will need to do three things...
# **Download the plugin and place it in Bukkit's plugin folder.** If you don't know where or what the Bukkit's plugin folder is, read [[http://wiki.bukkit.org/Setting_up_a_server|this]].
# **Now start up Minecraft Server via Bukkit.** If you don't know how to do this, I recommend rereading [[http://wiki.bukkit.org/Setting_up_a_server|this]].
At this point, you may be asking yourself: **How do I get to the WellWorld?**
There are two options...
# **Press "T", type in "/WellWorld" and press return
# **OR... you can use a multiverse plugin and use the WellWorld as the generator for one of your worlds. We use [[http://dev.bukkit.org/server-mods/multiverse-core/|Multiverse]].
If you are still confused then rereread [[http://wiki.bukkit.org/Setting_up_a_server|this]]. :-)
----
=== YML Options ===
<<code>>
# WellWorld Global Options
Global:
BedrockWalls: false
WallDoorways: true
HexishWells: true
<</code>>
What the global options means...
|Option|Description|Default|
|**BedrockWalls**|obsidian or bedrock walls|false|
|**WallDoorways**|pathways through the walls|true|
|**HexishWells**|hexagonally laid out wells|true|
----
=== Included Well Generators ===
==== ones so far ====
* Knolls
** a simple world generator that looks like MineCraft... sorta
* Alien World
** a simple alien-esque world generator
* Alien Cavern
** ... cavern-ish variation of the above generator
* Realistic Moon
** loosely based on Dinnerbone's BukkitFullOfMoon (see below) but modeled after real moon/planet surfaces
* Basalt Field
** loosely based on [[http://science.nationalgeographic.com/wallpaper/science/photos/rocks/giants-causeway/|basalt columns]]
* Volcano Island
** an erupting volcano surrounded by water
* Platform of Doom
** a maze of platforms, watch your step
* Smooth Snowland
** an experiment using variable high snow blocks. almost a smooth landscape, very non-Minecraft looking...
{{http://dev.bukkit.org/media/images/37/609/BuiltinWells.jpg|Our built in wells}}
==== Ones from CodenameB (thx sir!) ====
* BananaOctave
* BananaTrig
* BananaSky
* BananaVoid
* BananaForest
* BananaIce
{{http://dev.bukkit.org/media/images/37/606/BananaWells.jpg|CodenameB's Banana wells}}
==== Ones from Khyperia's TrippyTerrain (thx sir!) ====
* Khyland
* Pancake
{{http://dev.bukkit.org/media/images/37/610/KhyperiaWells.jpg|Khyperia's TrippyTerrain wells}}
==== proof of concept wells, not enabled (kinda boring to look at) ====
* SimplexNoise // plain stone sculpted SimplexNoise
* SimplexOctave // plain stone sculpted SimplexOctave
* VeryEmpty // Big empty box
* VerySimpleFlat // ... with some stone and a sprinkle of ores
* VerySimpleWater // ... with some water on top of it
* VerySimpleHilly // ... sculpted with SimplexOctave
==== conversions of other folks world generators, not enabled as I don't have their permission ====
* DinnerboneMoon // based on Dinnerbone's BukkitFullOfMoon
* MicroNordic // based on s1mpl3x's 50 line WGEN