Creation/Dev/Terrain Generator: Difference between revisions

From Graal Bible
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 3: Line 3:
maps for Graal which use 3D terrain.
maps for Graal which use 3D terrain.


[[Image:terraingenerator.png|320px]]
[[Image:Terrain Generator.png|320px]]


==Usage==
==How To Generate and Use a Terrain Map Offline==
Start TerrainGenerator.exe and click on 'Generate World' to see a map generated using fractal algorithms. To make an island click on the 'Islands' preset button first. For a more detailed view click on 'Show level details'. You can also directly edit the terrain by clicking on the grid and moving the mouse up/down.


==Random seeds==
'''The Terrain Generator is an external program that you can download on the login server, and use to generate terrain maps, as seen on [[Worlds/Graal Kingdoms|Graal Kingdoms]].  You typically won't use this program unless you are staff on [[Worlds/Graal Kingdoms|Graal Kingdoms]], but for all intents and purposes, here is a guide telling how to use this program.
For finding the best map you will need to click several times on the 'Generate World' button. Once you have found a good one, you can write down the random seed that is displayed in the upper right corner of the window. Using that number you can always generate the map again - click on 'random', then enter the number.


==Export==
'''Guide by [[Users:Fowlplay4|Fowlplay4]], with additional information from [[User:Stefan|Stefan]].'''
Click on the save button (disc-icon) to save the generated world as .gmap file. If you enable 'Generate Graal levels' then the terrain generator will also generate all the needed level files and save them in the same folder.


==Enable the map in Graal==
'''Note:''' You can replace ''yourworld'' (below) with anything you want; typically it should be set as the name of your server, unless you are developing for Graal Kingdoms.
For offline tests, add the gmap name into a file loadgmaps.txt, and put that text file into the Graal folder. Next time you are starting Graal it will automatically load the gmap if it is in the current folder or in the Graal folders. To see nice tiles you must add a tile definition: add a line
 
<pre>
* '''Step 1:''' Download (On Login Server), and run the Terrain Generator (Terrain Generator.exe)
picso.png,LEVELSTART,5,0,0
* '''Step 2:''' Change the Generator Options to your liking. (See Image Below)
</pre>
** Click ‘’Generate World’’ to generate a map.  (Map is generated using fractal algorithms.)
to levels/tiledefs/tiledefsoffline.txt. LEVELSTART is the first part of the map name, e.g. 'myworld' in 'myworld.gmap'.
** To make an island, click on the ''Islands'' present button.
** For a more detailed view, you can click on ''Show Level Details''.
** To directly edit the terrain, move the mouse up and down will clicking and holding the grid.
** You may need to click ''Generate World'' several times in order to find the best map.
** After you find the best map, you can take note of the random seed that is shown in the top right corner of the window.
** You can use this number / random seed to re-generate the same map in the future.  (Click on ''random'', and enter the number.)
 
[[Image:Terraingenguide1.png|300px]]
 
* '''Step 3:''' Check off ''Generate Graal levels''.
* '''Step 4:''' Click ''Generate World''.
* '''Step 5:''' Create a Blank Folder for your New GMap (See Image Below).
 
[[Image:Terraingenguide2.png|300px]]
 
* '''Step 6:''' Save ''yourworld.gmap'' in your new folder.
* '''Step 7:''' Navigate to your new overworld's folder; if done correctly, you should see all the levels in the folder. (See Image Below)
 
[[Image:Terraingenguide3.png|300px]]
 
* '''Step 8:''' Open ''yourworld_aa-01.nw''.
* '''Step 9:''' Lay an empty NPC on the level. (See Image Below)
 
[[Image:Terraingenguide4.png|300px]]


==Using it online==
* '''Step 10:''' Open the NPC and copy and paste the following script:
Upload the gmap, and add a line
  gmaps=LEVELSTART
to the serveroptions. You can put several maps into the same line, separate their names with commas. You can also add several gmaps= lines. Afterwards upload the sublevels. Now you should be able to enter the map. To set the good tiles you need to call the 'addtiledef' command in a weapon script. Add a weapon called '-Initialization' (the minus for not displaying it in the weapon list), set the script to this:


<pre>
<pre>
//#CLIENTSIDE
//Tutorial by fp4
function onCreated() {
//#CLIENTSIDE  
   addtiledef("picso.png", "LEVELSTART", 5);
if (created) {  
   loadmap("GMAPNAME");
  removetiledefs;
   addtiledef picso.png,yourworld_,5;  
   loadmap yourworld;  
}
}
</pre>
</pre>


The 'loadmap' command is not really necessary, but can speed up the entering of maps because the map is preloaded. To add that weapon script to each player, add following script to the 'Control-NPC' of your server:
* '''Step 11:''' Make sure to change ''yourworld_'' to the name of the gmap you used earlier. Close the NPC Window / Script.
* '''Step 12:''' You should see the terrain properly with the default [[Worlds/Graal Kingdoms|GK]] Tileset.  (''picso.png'')


<pre>
To manipulate the terrain in the level editor, just click and drag the + symbol up or down.
function onActionPlayerOnline() {
  addweapon("-Initialization");
}
</pre>


==Using different graphics==
The GMap can then be uploaded to your server and be set up and used like any other GMap!
If you want to replace picso.png with new tiles then just change the tiledefsoffline.txt file (for offline testing) and the '-Initialization' weapon to use your new tiles instead of 'picso.png'. Don't forget to upload the tiles to the server. Do '/find filename' on RC to see if the folder configuration is
correct and people can download the file.

Latest revision as of 16:13, 17 April 2011

The terrain generator tool can be used to generate maps for Graal which use 3D terrain.

Terrain Generator.png

How To Generate and Use a Terrain Map Offline

The Terrain Generator is an external program that you can download on the login server, and use to generate terrain maps, as seen on Graal Kingdoms. You typically won't use this program unless you are staff on Graal Kingdoms, but for all intents and purposes, here is a guide telling how to use this program.

Guide by Fowlplay4, with additional information from Stefan.

Note: You can replace yourworld (below) with anything you want; typically it should be set as the name of your server, unless you are developing for Graal Kingdoms.

  • Step 1: Download (On Login Server), and run the Terrain Generator (Terrain Generator.exe)
  • Step 2: Change the Generator Options to your liking. (See Image Below)
    • Click ‘’Generate World’’ to generate a map. (Map is generated using fractal algorithms.)
    • To make an island, click on the Islands present button.
    • For a more detailed view, you can click on Show Level Details.
    • To directly edit the terrain, move the mouse up and down will clicking and holding the grid.
    • You may need to click Generate World several times in order to find the best map.
    • After you find the best map, you can take note of the random seed that is shown in the top right corner of the window.
    • You can use this number / random seed to re-generate the same map in the future. (Click on random, and enter the number.)

Terraingenguide1.png

  • Step 3: Check off Generate Graal levels.
  • Step 4: Click Generate World.
  • Step 5: Create a Blank Folder for your New GMap (See Image Below).

Terraingenguide2.png

  • Step 6: Save yourworld.gmap in your new folder.
  • Step 7: Navigate to your new overworld's folder; if done correctly, you should see all the levels in the folder. (See Image Below)

Terraingenguide3.png

  • Step 8: Open yourworld_aa-01.nw.
  • Step 9: Lay an empty NPC on the level. (See Image Below)

Terraingenguide4.png

  • Step 10: Open the NPC and copy and paste the following script:
//Tutorial by fp4 
//#CLIENTSIDE 
if (created) { 
  removetiledefs; 
  addtiledef picso.png,yourworld_,5; 
  loadmap yourworld; 
}
  • Step 11: Make sure to change yourworld_ to the name of the gmap you used earlier. Close the NPC Window / Script.
  • Step 12: You should see the terrain properly with the default GK Tileset. (picso.png)

To manipulate the terrain in the level editor, just click and drag the + symbol up or down.

The GMap can then be uploaded to your server and be set up and used like any other GMap!