PTM173 1.7.3 Terrain Generation

Notice

I'll be putting minecraft down for a while and will likely not be maintaining this project. I'll be passing the source on to others and putting up a stripped down version on this site so that others may continue if they chose to. I may come back to minecraft one day particularly when there is decent plugin support. In the mean time I recommend that everyone deprecate and move away from their existing 1.7.3 worlds. If someone produces a plugin of a similar nature I will provide a link at the top of this page.

In my opinion, the simplest thing to do if you really want to keep the world is to generate a ton of terrain then lock the borders so that no terrain can be generated.

If you have questions or concerns you are welcome to pm me. I'll get to them when I can. Remember if you have frustrations the best people to communicate those to are Jeb and the rest of Moyang team particularly about deobfuscating the code, including a reasonable license, and making plugin support a priority. We all love what minecraft represents as an open, modifiable, multiplayer, infinite world but it's just been slow to develop into a solid game that the community enjoys improving upon as much as playing. I'll be maintaining PTM1.7.3v3.x for CB 1.1-R1 and after that will no longer be creating artifacts.

Summary

Essentially this is a rework of Phoenix Terrain Mod to plug into the terrain generation from 1.7.3 so that future versions of craft bukkit servers can have older worlds that continue to generate proper terrain for new chunks without having to "fix" the terrain by smoothing between 1.7.3 and 1.0 terrain.

Here is a comparison of the terrain generation of a world originally created in 1.7.3 where I've gone to the border where new chunks are being generated: Terrain Comparison (the image shows 1.8.1 but looks the same with 1.1 .. I'm just lazy)

• 1rst image (top): 1.8.1 with PTM173 enabled
• 2nd image (middle): 1.8.1
• 3rd image (bottom): 1.7.3

Status

PTM173 has been through several comparison tests between 1.0 PTM173 and 1.7.3 itself on both a test world and on a live server. It is currently running on a live server. There may be known issues with the latest release and I am continuing to test. Please create tickets as you run into issues.

Installation

Setup

• download the latest version of PTM173.jar: PTM173v3.1
• source to start working on this yourself is here in truncated form: PTM173v3.1_src
• put PTM173.jar in your plugins dir for your bukkit craft installation
• if not running multiverse: change bukkit.yml so that the world generator is set to "PTM173" by adding this to the bottom of the file:

     worlds:
          world: 
              generator: PTM173

WARNING: be careful when typing this out by hand the space between "generator:" and "PTM173" is important. If you notice when starting up your server that "generator:PTM173" has been moved to be on the same line as "world:" then you are likely missing a space and are NOT generating PTM173 terrain.

• if running multiverse: change your generator in the plugins/Multiverse-Core/worlds.yml file to "PTM173" by adding this to the yml block for the world you want to generate 1.7.3 terrain. For example here's a test world config in worlds.yml:

     worlds:
         test_world:
             gamemode: SURVIVAL
             keepspawninmemory: true
             scale: 1.0
             animals:
                 spawn: true
             pvp: true
             entryfee:
                 amount: 0.0
                 currency: -1
             alias:
                 color: WHITE
                 name: ''
             allowweather: true
             monsters:
                 spawn: true
             hunger: true
             spawn:
                 yaw: 0.0
                 pitch: 0.0
                 z: 0.0
                 y: 64.0
                 x: 0.0
             environment: NORMAL
             respawnworld: ''
             tempspawn: ''
             generator: PTM173
             seed: ''

Running

There are no special steps when running craft bukkit server to run PTM173; however, it's good to know what to look for to ensure that it has started up appropriately:

• This indicates PTM173 is recognized and has loaded properly: "[INFO] PTM173 v2.2 is now enabled"
• This indicates the world that PTM173 is running on : "[INFO] PTM173: enabled for 'world'"
  Note by default craft bukkit runs on the world named 'world'

Upgrading

PTM173 does not generate files and therefore upgrading simply requires replacing the existing PTM173.jar

FAQ

Q: I'm having issue XXXX, and I'm stumped can you help me out?

A: I'd be more than happy to help you, but I do need some information. Before leaving comments, pming me, or creating a ticket please make sure you have following information ready and provide it as appropriate (it doesn't hurt to add tickets so please don't hesitate to do so):

• version of the craft bukkit server and PTM173
• are you running vanilla craft bukkit or do you have multiverse installed?
• bukkit.yml or worlds.yml (if running multiverse) file
• console logs specifically errors or exceptions
• a list of your currently installed plugins
• screenshots and/or a brief description of the problem so I can reproduce it
• anything special about your setup that I might not otherwise expect

Q: XXXX plugin conflicts with PTM173; I can't use one or the other or they just don't work together as expected. Can you help?

A: I'd be happy to help resolve these conflicts. In addition to the information I mentioned in the previous QA related to reporting an issue please also provide the following information so that we can track the issue:

• definitely create a ticket (because there will probably be several interactions it's nice to have some place to track the progress)
• the conflicting plugin and it's version
• a description of how to reproduce the conflicting behavior
• a description of the expected behavior

Q: Does this mod conflict with Phoenix Terrain Mod?

A: No, I changed the package names to allow for both to coexist, removed the "ptm" commands, and have added all relevant terrain generation source under a package that does not conflict with PTM, craft bukkit, or minecraft.

Q: How much of this plugin uses Phoenix Terrain Mod, Minecraft 1.7.3, and craft bukkit?

A: This is my first plugin so I based it around the Phoenix Terrain Mod code, but it doesn't really utilize any of that functionality; it was just nice to have the framework in place to see how to handle object and chunk generation. Minecraft 1.7.3 class files are used to generate chunks and objects. Craft Bukkit is the framework on which all of this is allowed to function. Major props go to each of these communities.

Q: Does this mod support the Nether and/or will it in the future?

A: It currently does not support Nether chunk generation. Currently there is no demand for this. In the future I may investigate it further, but for now there isn't enough of a problem to warrant spending time on this.

Q: Will this mod be updated for future versions of minecraft and craft bukkit?

A: No, I'll be passing off the source shortly so that others may continue the work if they chose. I'm putting minecraft mod development down for awhile.

Known Issues

Biomes, particularly swamp biomes now have discolored grass, trees, etc, which often times is unexpected and just looks bad.

This issue is new in MC 1.0.0 and specific, unfortunately, to the client side code. It's basically just a visual artifact. The only way around this is to mod the client side using something like this: http://www.minecraftforum.net/topic/820720-100-swamp-color-reverter/

This issue also seems to affect rainfall/snow. Not what actually accumulates so much as what gets rendered on the client side. From what I can tell this is not a server side issue but again I'll see if I can work around it.

I've been unable to figure out a way to trick the client side from the server. I don't believe these issues will be fixed any time soon and likely not at all.