Bay 12 Games Forum

Please login or register.

Login with username, password and session length
Advanced search  
Pages: [1] 2 3 ... 10

Author Topic: Common Question: When do I need to generate a new world?  (Read 158357 times)

Jay

  • Bay Watcher
  • ☼Blue Horse☼
    • View Profile
Common Question: When do I need to generate a new world?
« on: December 29, 2008, 06:11:32 pm »

Short answer: Generate a new world.  If you really really want to keep your current world, there are a few rules:

Virtually all entity changes whatsoever require a new world. Some don't, and some only do when certain conditions are met. It would be impossible to document every case here.
Adding/removing entire objects requires a new world. NOTICE: Changing an object's identifier does both of these.
All changes to tags except those in entity objects do not require a new world. NOTICE: Some, such as biomes, are highly relevant during worldgen and may not entirely have the desired effect.

Make sure you make your changes in the copy of the raws included in the region's /data/save folder instead of the /raw/objects folder, which is only used during new-world-generation.
If you plan on making a new world, obviously, change the base raws.

Play it safe and generate a new world if you're unsure.

Glossary of terms:
entity -- Refers to an object from any file with a header of [OBJECT:ENTITY]; the same lexicon is true for all other variations of OBJECT:X
tag -- A singular bracketed item that defines a characteristic of an object. Example: [SPEED:900]
object -- An entire collection of tags, preceded by one object tag that makes up virtually anything in the game. Example: [CREATURE:DWARF]
identifier -- In this instance, it refers to the second half of the object tag, which absolutely must be unique to that object, no matter what.

Spoiler: Technical Details (click to show/hide)

UPDATE 7/3/2012: I've experimentally made the line referring to tag changes a flat "all". It may well be wrong, but I haven't seen an exception save what's listed, so...

Let me make it perfectly clear to all who read this. If you find anything that doesn't jive with what I have here, please post in this thread, lest I never hear about it. I can't be everywhere. Also, it's worth noting that I can't test every plausible scenario. I need you to let me know that I'm wrong. (Excepting the entity stuff - I can't maintain that here. I'll link to a Wiki page where people are attempting to do so if such a thing is made, but I simply don't have the time, patience, or especially the space in this post to try.)
Also, I might not be paying the most attention at a given moment. Use this thread to discuss, and if you certifiably prove I need to add something up here, just toss me a PM and I'll wake up and get right on it.
« Last Edit: January 31, 2014, 02:21:13 am by Jay »
Logged
Mishimanriz: Histories of Pegasi and Dictionaries

Vlynndar

  • Bay Watcher
  • To the skies! All of them!
    • View Profile
Re: Common Question: World Generation
« Reply #1 on: January 22, 2009, 02:05:35 pm »

This is good reference. Thanks for putting this in clear view.
Logged
For that viciously bad pun, I'm gonna introduce a NPC named Vlynndar just so that I can kill him of in a cruel and unusual way.
Watermelons are pretty important.

i2amroy

  • Bay Watcher
  • Cats, ruling the world one dwarf at a time
    • View Profile
Re: Common Question: World Generation
« Reply #2 on: January 22, 2009, 08:08:07 pm »

Don't forget that moving an entire entry from one text document to another will require regen, as the game takes the deleting/adding thing on a text document by text document basis, not on an entire raw basis.
Logged
Quote from: PTTG
It would be brutally difficult and probably won't work. In other words, it's absolutely dwarven!
Cataclysm: Dark Days Ahead - A fun zombie survival rougelike that I'm dev-ing for.

Footkerchief

  • Bay Watcher
  • The Juffo-Wup is strong in this place.
    • View Profile
Re: Common Question: World Generation
« Reply #3 on: January 24, 2009, 07:17:08 am »

Also, adding/removing/renaming the text files themselves apparently requires deletion of /data/objects.
Logged

Glacies

  • Bay Watcher
    • View Profile
Re: Common Question: World Generation
« Reply #4 on: February 05, 2009, 01:57:05 pm »

Also, adding/removing/renaming the text files themselves apparently requires deletion of /data/objects.

Elaborate on this, please?

Footkerchief

  • Bay Watcher
  • The Juffo-Wup is strong in this place.
    • View Profile
Re: Common Question: World Generation
« Reply #5 on: February 05, 2009, 03:51:18 pm »

Elaborate on this, please?

That was kind of cobbled together from secondhand sources, so I can't elaborate much.  i2amroy could explain in more detail, but people have noticed oddities when they shuffled the raws around, and deleting data/objects seems to fix it.  It's probably another issue with the indexing of various raw entries.
Logged

Untelligent

  • Bay Watcher
  • I eat flesh!
    • View Profile
Re: Common Question: World Generation
« Reply #6 on: February 05, 2009, 07:04:14 pm »

In my experience, adding new .txt files doesn't require a deletion of data/objects, only removing or renaming them.
Logged
The World Without Knifebear A much safer world indeed.
regardless, the slime shooter will be completed, come hell or high water, which are both entirely plausible setbacks at this point.

i2amroy

  • Bay Watcher
  • Cats, ruling the world one dwarf at a time
    • View Profile
Re: Common Question: World Generation
« Reply #7 on: February 05, 2009, 11:24:48 pm »

Elaborate on this, please?
That was kind of cobbled together from secondhand sources, so I can't elaborate much.  i2amroy could explain in more detail, but people have noticed oddities when they shuffled the raws around, and deleting data/objects seems to fix it.  It's probably another issue with the indexing of various raw entries.

For the renaming of text files, the game creates a cache of each text file based on name. This means that if you change the name of or delete an entire old text file, the game will not erase that cache of the old text file. This in turn means that any entries in that text file will remain in any further world generations, and the only way to solve the problem is to delete that text file's cache in data/objects. For example, if I have a file that is named bob.txt in the raws, than in data/objects there will be a file named bob. The file in data/objects is a cache that contains all data in bob.txt stored so the game can use it. Any changes I make to bob.txt are stored in the bob file which is rewritten every time you start dwarf fortress. However, if I completely remove or rename the bob.txt file, than the bob file is not overwritten, meaning that it retains all of the information of the bob.txt file. So if I had a creature in the bob.txt file, and I delete the bob.txt file, that creature will remain in the world until I deleted the bob file from data/objects. Heck, you could even go right now and delete every text document in the raws file and as long as the data/objects file was untouched your game should still run fine. This only applies to complete removal or renaming of text files, though, if you then create another file that has the same name as one of the old files, then it will overwrite that cache and cause bugs.
Logged
Quote from: PTTG
It would be brutally difficult and probably won't work. In other words, it's absolutely dwarven!
Cataclysm: Dark Days Ahead - A fun zombie survival rougelike that I'm dev-ing for.

LegoLord

  • Bay Watcher
  • Can you see it now?
    • View Profile
Re: Common Question: When do I need to generate a new world?
« Reply #8 on: February 10, 2009, 08:43:42 pm »

Actually, moving an entry to another .txt does not require regeneration as long as you cut the entry instead of copying;  I've done it before multiple times, even between releases of the LEGO mod.  I haven't had any problems playing with older forts. 
Logged
"Oh look there is a dragon my clothes might burn let me take them off and only wear steel plate."
And this is how tinned food was invented.
Alternately: The Brick Testament. It's a really fun look at what the bible would look like if interpreted literally. With Legos.
Just so I remember

Jay

  • Bay Watcher
  • ☼Blue Horse☼
    • View Profile
Re: Common Question: When do I need to generate a new world?
« Reply #9 on: February 10, 2009, 10:12:55 pm »

Adding text files & /data/objects: I've confirmed that you do not need to delete anything, as you're adding a new file, hence it would not have a cache of an old file that you'd have to delete...

Oh yeah, forgot to mention: I've been stickied!
Logged
Mishimanriz: Histories of Pegasi and Dictionaries

Assassinfox

  • Bay Watcher
  • [FANCIFUL]
    • View Profile
    • Raging at the Box
Re: Common Question: When do I need to generate a new world?
« Reply #10 on: February 13, 2009, 04:40:27 pm »

Adding a new Body entry doesn't require a worldgen.

LegoLord

  • Bay Watcher
  • Can you see it now?
    • View Profile
Re: Common Question: When do I need to generate a new world?
« Reply #11 on: March 09, 2009, 08:02:36 pm »

Adding a new Body entry doesn't require a worldgen.
That's already there.
Logged
"Oh look there is a dragon my clothes might burn let me take them off and only wear steel plate."
And this is how tinned food was invented.
Alternately: The Brick Testament. It's a really fun look at what the bible would look like if interpreted literally. With Legos.
Just so I remember

Jay

  • Bay Watcher
  • ☼Blue Horse☼
    • View Profile
Re: Common Question: When do I need to generate a new world?
« Reply #12 on: March 10, 2009, 08:47:44 pm »

Adding a new Body entry doesn't require a worldgen.
That's already there.
You may want to check last edit on my post when you say that...
I believe I added that after that post.
Logged
Mishimanriz: Histories of Pegasi and Dictionaries

LegoLord

  • Bay Watcher
  • Can you see it now?
    • View Profile
Re: Common Question: When do I need to generate a new world?
« Reply #13 on: March 11, 2009, 03:03:00 pm »

Oh, sorry about that.  I think I must have misread it.
Logged
"Oh look there is a dragon my clothes might burn let me take them off and only wear steel plate."
And this is how tinned food was invented.
Alternately: The Brick Testament. It's a really fun look at what the bible would look like if interpreted literally. With Legos.
Just so I remember

InsanityPrelude

  • Bay Watcher
  • O SHI--
    • View Profile
Re: Common Question: When do I need to generate a new world?
« Reply #14 on: March 16, 2009, 01:30:12 pm »

Messing with reactions requires a regen, doesn't it?
Logged
Forget down stairs, make an up stair
And then what?  Mine the sky? . . .  Actually, that'd be awesome.
Pages: [1] 2 3 ... 10