Guide on making a Custom Culture

From Millénaire Wiki
Jump to: navigation, search

This guide is a work in progress Gavinator25 02:27, 15 April 2013 (CEST)

This guide offers advice on how to develop your custom buildings and villages into a whole culture.

It is the last in a series of guides which lead to custom development of a whole culture:

  1. The Guide on making Custom Buildings.
  2. The Guide on making a Town Hall.
  3. The Guide on making Custom Villages.
  4. This Guide on making a Custom Culture.

Creating a culture can seem like a large and impossible task, especially if you have no idea where to start. The purpose of this guide is to make this task a little smaller for you. I will assume you already have covered the material in creating a building, village, and townhall. For this entire guide, we will use a made up culture, the Vikings.

Contents

[edit] Creating Your Culture File

When you first decide on creating your very own culture, you need to choose which culture. If you haven't already choosen a culture, there are some great culture suggestions over here. (Link to suggestion page) After you chose your culture, you need to start work on the your file that will go in the custom culture file. The file should go like this, with the example culture being the 'Vikings':

vikings
buildings
lonebuildings
namelists
shops
villagers
villages
culture.txt
language

[edit] Buildings Folder

In this folder you are going to have three folders; core, extra, and lone. When starting to create your culture, do not try and over work yourself. Make your towncentre, and when that is complete and actually works, create other buildings. Only focus on core buildings at first, as they are the most important when you are trying to get your culture out.

  • core- In here are your main buildings, or any buildings that have a main chest. Your towncentre also goes here.
  • extra- In this folder are the buildings that are the buildings that are for looks, like fountains or a well.
  • lone- Although it may look like this is the same file as the lonebuildings, it is not. In this folder goes the .png file of the lonebuilding and the .txt file of the lonebuilding. The .txt file is just like a normal building .txt file.

[edit] Languages

This folder will hold your languages and any amount of text that is seen in one language. This folder will hold dialogue, reputation, buildings, sentences, and the string texts. This folder can fill in all sorts of things for you, and without it you wont be able to trade, or talk to the village chief.

[edit] Lonebuildings Folder

In this folder are the lonebuilding text files. There are no other folders in this folder, just text files. The key to understanding how to create lonebuildings, is to realize that lonebuildings are not buildings set out by themselves, but they really are just one building towns. There are many examples of lonebuildings in other cultures, but some do not work. It is important to realize why some lonebuildings work, and why some do not, as you can better learn from previous mistakes. The files are like normal building text files, but with some added parameters.

  • name-This parameter sets the name of the building
  • weight-This represents the chance it has to spawn, works like the weigh parameter in villages.
  • radius
  • mindistancefromspawn-The minimum amount of distance that this lonebuilding will spawn from the original spawn point.
  • biome-The biomes this lonebuilding will appear in. Can be included multiple times.
  • startingbuildings:centre-This tag is where the lonebuilding's name will be. Notice how this parameter is exactly the same to the parameter in villages, without the other buildings of course.

[edit] Namelists Folder

In this folder are the namelists for generating names for your villagers. It is recommended that you have at least three name files in here. One for males, one for females, and the last for last names. To make a namelist, just create a text file and put one name on each line. Here is a list of names for a Viking male:

Ysmir
Wulfgar
Ulfric
Torygg
Talos
Dovahkiin

These manly Nord-I mean Norse names will add more to the overall feel of the viking culture. You can't have an angry, barbarian viking named Bill. It should also be noted that you should pick names specific to that time period and culture.

[edit] Shops Folder

In this folder are the shop text files for the villagers who sell things. In theory, you only need one shop file for the towncentre, but it adds more to your culture to have multiple shops in your town.

[edit] Villagers Folder

This folder holds the villager text files. These files hold all sorts of parameters and tags. This is also where you assign your skins to the villager. You can also assign multiple skins to one villager, then upon generation the villager will randomly be assigned one of the skins.

[edit] Villages Folder

The villages folder holds the text files for your village. If you want to make a custom village, check out this guide (link)

[edit] Culture Text File

This is a text file that tells what things are specific to the culture. If your culture is not included in the main Millenaire mod, it is recommended you do not mess with this.

[edit] Skins Folder

{{{{This section should be edited- it does not appear to reflect the current state of the mod as of January 2014. While some items need to be placed in various folders, adding a new culture no longer requires editing the mod .zip itself.}}}}

Now that you have put together your main folder, you need to go behind the scenes a bit. The main file 'vikings' can go in the custom cultures file, but your skins folder has to go inside the Millenaire zip. Your skins folder should hold the skins themselves, and they can be named however you would like. Here is an example of the skins folder for the Vikings:

vikingskins
ML_vikingclanleader0.png
ML_vikingclanlady0.png
ML_vikingclanlady1.png
ML_vikingtroop0.png
ML_vikingtroop1.png
ML_vikingtroop2.png
ML_vikingworker0.png
ML_vikingwife0.png

Note that the 'ML' before the name of .png file does NOT mean anything. The Norman and Hindu skin files use 'ML' before their skin files, so I choose to do it too. You could do viking_vikingwife0.png if you wanted to, or just viking_wife0.png. The important thing is you need to have the number after the name, as it tells which number of skin that particular skin is.

[edit] Skins Folder Placement

When you finish your skins folder and your villager files line up correctly with their respective skins, you can put your skins folder in its place. The skins folder goes inside the actual .ZIP of Millenaire, and the .ZIP of Millenaire is in the mods folder. Make sure you do not place it in the Millenaire or Millenaire-custom folders. Once inside the Millenaire .ZIP, place the skins folder within the 'graphics' folder, and then within the 'mob' folder. The final place of your skins folder is inside the 'mob' folder, next to the other cultures' skin folders. So to recap all of this:

.minecraft
mods
millenaire.zip
graphics
mob

Once it is in here it doesn't need to be messed with anymore. One thing to remember is that it goes inside the 'millenaire.zip', once inside the 'mods' folder. NOT the 'millenaire' folder or 'millenaire-custom' folder.

[edit] Testing

So now that your culture seems complete, and the file is in order, it is time to test your work. In this section of the guide, I will instruct you on how to properly test your culture and see if everything works like it should.

[edit] Inserting the Files

When you start testing, you should probably take your work and create a copy of it. Once you do that make sure your files are all in the right place, including the skins folder. After this, just start up Minecraft and hope for the best. If it crashes, check the Millenaire log. The Millenaire log is a text file that is updated every time you use Millenaire. It is located in the Millenaire folder, and it is titled Millenaire. Throughout the whole process of testing your culture you will need to refer to this log many times.

[edit] FAQ

My culture is on the list when I try to spawn it using the wand and gold block, but the village name isn't?

This is most likely an error in your village file, such as buildings not having the correct requirements, or incorrect statements in the code.

My townhall spawns correctly, but my signs are all blank?

This is most likely due to an error in your .png file. You need to change the colors to match Sign Wall.

Inside my townhall, the villager's name ends in 'null'?

'null' is just a term Millenaire uses to mean 'Nothing Here', to fix this you should find the name parameter and fill it in.



[edit] Packaging for the Library

Now that you have your culture finished and complete, it is now time to package up for the Library. First, you will want to test it out yourself, and make sure it works properly. Okay, you're back already? Fine, let's carry on!

[edit] The .ZIP

To start this off, you will need to create a .ZIP. The .ZIP is a compressed file or folder that is very easy to share and is the main form of a download. If you notice, you downloaded Millenaire as a .ZIP file, and most likely, you have seen them more than just with Millenaire. So you are going to name your .ZIP, and if I created a .ZIP for my Vikings, it would look like this:

[1.5.1] Viking Culture v1.0.0
  • The '[1.5.1]' is the current version of Minecraft (As of this writing), and is not necessary, but it is good ettiquette in my opinion.
  • The 'Viking Culture' is the name of the culture, so it would be '<name> Culture' for you.
  • The 'v1.0.0' represents the current version of your culture, so v1.0.0 is Version 1.0.0, which is basically alpha version.

[edit] Inside the .ZIP

Inside of your newly created .ZIP, you will have your culture folder, your skins folder and a .txt file for instructions. The text file for the instructions should be named 'Read me', so that the user of your add-on will have the first impulse to read the file. The 'Read me' file needs to include instructions on where to put the culture folder, and the skins folder. If you update your 'Read me' file and culture folder frequently, you could even include a log of updates or a list of things you would like help with. The important thing to remember though is make sure the instructions are clear, and there is some form of contact information for the reporting of bugs or feedback.

[edit] Packaged

Once you have done this, you can now upload your creation to the Library. Make sure to include plenty of screenshots to showcase your culture, and talk on the Millenaire forums to get your culture out there. Once you have put your culture out there, make sure to continually update it until it is complete. If your culture is within the 11th century, maybe you can try and get your culture added into the offical mod!

Personal tools
Namespaces
Variants
Actions