Difference between revisions of "ZONE"

From GTAMods Wiki
Jump to navigation Jump to search
m
 
(41 intermediate revisions by 11 users not shown)
Line 1: Line 1:
−
== Introduction ==
+
{{IplSection
−
A '''zone''' is an area in the game used to show the text of the zone being entered, to load islands, and to create locations to spawn specific vehicles and pedestrians. It is controlled by <code>.zon</code> files.
+
| game        = {{Icon|t}} {{Icon|LCS}} {{Icon|VCS}} {{Icon|4}}
 +
| description =
 +
}}
 +
'''ZONE''' is a section in the [[Item Placement|item placement]] file in [[GTA III]], [[Vice City]], [[San Andreas]], [[Liberty City Stories]], [[Vice City Stories]], and [[GTA IV]]. It creates an area in the game used to show the text of the zone being entered, to load islands, and to create locations to spawn specific vehicles and pedestrians. The section is mainly placed in <code>.zon</code> files, which use the IPL format, but it can also be placed in <code>.ipl</code> files.
  
−
==Structure==
+
== Format ==
 +
{{Pre|
 +
zone
 +
# III/VC/SA
 +
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Level
 +
# IV
 +
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Level, Text
 +
end
 +
}}
  
−
All the <code>.zon</code> files start with a section identifier and ends with the keyword "end", both in a single line.
+
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
 +
! style="width: 3em;"| {{Icon|3}} {{Icon|VC}}
 +
! style="width: 3em;"| {{Icon|SA}} {{Icon|4}}
 +
! style="width: 12em;"| Identifier
 +
! style="width: 6em;" | Type
 +
! Description
 +
|-
 +
| colspan="2" | A || | Name || string || Name and text of zone used from the <code>.gxt</code> file. Stick to 7 char max
 +
|-
 +
| colspan="2" | B || | Type || integer || Type of zone ([[#Major files|see below]])
 +
|-
 +
| colspan="2" | C,D,E || | X1, Y1, Z1 || float[3] || A point which corresponds to the corner of the box, usually the lower left
 +
|-
 +
| colspan="2" | F,G,H || | X2, Y2, Z2 || float[3] || A point which corresponds to the opposite corner of the box, usually the upper right
 +
|-
 +
| colspan="2" | I || | Level || integer || The level number ([[#Major files|see below]])
 +
|-
 +
| | - || | J || {{a|c}} | Text || string || Text of the zone used from the [[GXT]] file<br>
 +
|}
  
−
Example:
+
Note that for San Andreas, the text of the zone to be displayed is also related to by an internally hardcoded table which links that zone name to its respective audio description for the police radio. This is actually the cause of a bug in the game - the zone 'SUN' (which is correctly named 'Temple' in the GXT file) gets announced as 'Sunnyside' on the police radio. This is because the internal table has two consecutive entries called 'SUN' and only the second one gets used, meaning whenever the player is in a zone named and defined as 'SUN' in this file, the police will always announce this as 'Sunnyside' since 'SUN' points to that audio entry.
−
zone
 
−
...
 
−
end
 
  
−
==GTA3==
+
== Major files ==
−
===Gta3.zon===
+
Most of these zone files are saved into the [[.b|game save]] so any changes made to these files require starting a new game.
−
The <code>gta3.zon</code> controls the text of the zone that shows up in the game as you enter a new zone. The <code>main.scm</code> uses this to check if you are in the zone.<br>
+
=== GTA III ===
−
''Format:''
+
[[File:III zone.jpg|thumb|A map of GTA III's <code>gta3.zon</code> areas, including the hardcoded <code>CITYZON</code> area]]
−
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Island
+
* Level number 1: Portland
−
;Name: Name and text of zone used from the <code>.gxt</code> file
+
* Level number 2: Staunton
−
;Type: Type of zone
+
* Level number 3: Shoreside Vale
−
;X1, Y1, Z1: The bottom left corner of the zone
+
==== gta3.zon ====
−
;X2, Y2, Z2: The top right corner of the zone
+
* Type: 0, 1, or 2
−
;Island: The island number
+
The <code>gta3.zon</code> controls the text of the zone that shows up in the game as you enter a new zone. The original <code>main.scm</code> uses this file throughout the script so you cannot simply delete the lines in the file to prevent the zone's text from popping up in the game without editing the script file. The script file uses this to control how cars, peds, and gangs spawn in the map, and to check if you are inside the zone. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line:
−
The <code>gta3.zon</code> can be viewed through [[KEd]] but it can be only edited by hand. The <code>main.scm</code> uses this file so you cannot just delete the lines in the file to prevent the zone’s text from popping up in the game without editing the <code>main.scm</code>.
 
  
−
===Map.zon===
+
{{Pre|
−
The <code>map.zon</code> controls the loading of an entire island as you travel from one island to another. It tells the game where to load.<br>
+
CITYZON 0 -4000.0 -4000.0 -500.0 4000.0 4000.0 500.0 0
−
''Format:''
+
}}
−
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Island
 
−
;Name: Name of zone
 
−
;Type: Type of zone
 
−
;X1, Y1, Z1: The bottom left corner of the zone
 
−
;X2, Y2, Z2: The top right corner of the zone
 
−
;Island: The island number
 
−
The <code>map.zon</code> can be viewed through KEd but it can be only edited by hand.
 
  
−
==Vice City==
+
==== map.zon ====
−
===Info.zon===
+
* Type: 3
−
The <code>info.zon</code>, with the help of the <code>main.scm</code>, controls which pedestrian and vehicles spawn in that specific zone.<br>
+
The <code>map.zon</code> controls the loading of an entire island as you travel from one island to another. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line:
−
''Format:''
 
−
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Island
 
−
;Name: Name of zone
 
−
;Type: Type of zone (always 2)
 
−
;X1, Y1, Z1: The bottom left corner of the zone
 
−
;X2, Y2, Z2: The top right corner of the zone
 
−
;Island: The island number (always 1)
 
−
The <code>info.zon</code> can be viewed through [[KEd]] but it can be only edited by hand. The <code>main.scm</code> uses this file so you cannot just delete the lines in the file without editing the <code>main.scm</code>.
 
  
−
===Map.zon===
+
{{Pre|
−
The <code>map.zon</code> controls the loading of an entire island as you travel from one island to another. It tells the game where to load.<br>
+
THEMAP 3 -4000.0 -4000.0 -500.0 4000.0 4000.0 500.0 0
−
''Format:''
+
}}
−
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Island
 
−
;Name: Name of zone
 
−
;Type: Type of zone (always 3)
 
−
;X1, Y1, Z1: The bottom left corner of the zone
 
−
;X2, Y2, Z2: The top right corner of the zone
 
−
;Island: The island number (either 1 or 2)
 
−
The <code>map.zon</code> can be viewed through KEd but it can be only edited by hand. You can make the loading of the islands by deleting the entire section.
 
  
−
===Navig.zon===
+
=== Vice City ===
−
The <code>navig.zon</code> controls the text of the zone that shows up in the game as you enter a new zone. The main.scm uses this to check if you are in the zone.<br>
+
[[File:VC info.jpg|thumb|A map of Vice City's <code>info.zon</code> areas, including the hardcoded <code>CITYINF</code> area]]
−
''Format:''
+
[[File:VC navig.jpg|thumb|A map of Vice City's <code>navig.zon</code> areas, including the hardcoded <code>VICE_C</code> area]]
−
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Island
+
* Level number 1: Vice City Beach
−
;Name: Name and text of zone used from the <code>.gxt</code> file
+
* Level number 2: Vice City Mainland
−
;Type: Type of zone (either 0 or 1)
+
==== info.zon ====
−
;X1, Y1, Z1: The bottom left corner of the zone
+
* Type: 2
−
;X2, Y2, Z2: The top right corner of the zone
+
The <code>info.zon</code>, with the help of the <code>main.scm</code>, controls how cars, peds, and gangs spawn in the map. The original <code>main.scm</code> uses this file throughout the script so you cannot simply delete the lines in the file without editing the script file. This zone uses level number 1. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line:
−
;Island: The island number (always 1)
 
−
The <code>navig.zon</code> can be viewed through KEd but it can be only edited by hand. The <code>main.scm</code> uses this file so you cannot just delete the lines in the file to prevent the zone’s text from popping up in the game without editing the <code>main.scm</code>.
 
  
−
==San Andreas==
+
{{Pre|
−
===Navig.zon===
+
CITYINF 2 -2400.0 -2000.0 -500.0 1600.0 2000.0 500.0 0
−
The <code>navig.zon</code> controls the text of the zone that shows up in the game as you enter a new zone. It also controls which pedestrian and vehicles spawn in that specific zone, with the help of the <code>main.scm</code>.<br>
+
}}
−
''Format:''
 
−
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Island, Text
 
−
;Name: Name of zone
 
−
;Type: Type of zone (always 0)
 
−
;X1, Y1, Z1: The bottom left corner of the zone
 
−
;X2, Y2, Z2: The top right corner of the zone
 
−
;Island: The island number (always 1)
 
−
;Text: Text of the zone used from the <code>.gxt</code> file
 
−
The <code>main.scm</code> uses this file so you cannot just delete the lines in the file to prevent the zone’s text from popping up in the game without editing the <code>main.scm</code>.
 
  
−
===Map.zon===
+
==== map.zon ====
−
The <code>map.zon</code> is not used in San Andreas.
+
* Type: 3
 +
The <code>map.zon</code> controls the loading of an entire island as you travel from one island to another. You can disable the loading of the islands by deleting the entire section. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line:
  
−
==References==
+
{{Pre|
−
[http://www.gtaforums.com/index.php?showtopic=140597 Map File Definitions]
+
THEMAP 3 -2400.0 -2000.0 -500.0 1600.0 2000.0 500.0 0
 +
}}
  
−
[[Category:Map Formats]][[Category:GTA VC]][[Category:GTA SA]]
+
==== navig.zon ====
 +
* Type: 0 or 1
 +
The <code>navig.zon</code> controls the text of the zone that shows up in the game as you enter a new zone. A zone of type 1 means that the text of that zone will take priority if there are more than one overlapping zones (Junk Yard over Escobar International in this case). There is a zone of this zone type hardcoded into the game that would have an entry similar to this line:
 +
 
 +
{{Pre|
 +
VICE_C 0 -2400.0 -2000.0 -500.0 1600.0 2000.0 500.0 0
 +
}}
 +
 
 +
The original <code>main.scm</code> uses this file throughout the script so you cannot simply delete the lines in the file to prevent the zone's text from popping up in the game without editing the script file. The script file uses this to check if you are inside the zone. This zone generally used level number 1 but that column does not seem to have any effect.
 +
 
 +
===San Andreas===
 +
* Level number 1: Los Santos
 +
* Level number 2: San Fierro
 +
* Level number 3: Las Venturas
 +
====Info.zon====
 +
* Type: 0
 +
The <code>Info.zon</code> controls the text of the zone that shows up in the game as you enter a new zone. It also controls which pedestrian and vehicles spawn in that specific zone, with the help of the <code>main.scm</code>. The <code>main.scm</code> uses this file so you cannot just delete the lines in the file to prevent the zone's text from popping up in the game without editing the <code>main.scm</code>. This zone uses level number 1 only.
 +
 
 +
====Map.zon====
 +
[[File:sa_mapzon.jpg|thumb|A map of San Andreas' <code>map.zon</code> areas, including the hardcoded <code>THEMAP</code> area]]
 +
* Type: 3
 +
The <code>map.zon</code> controls the island zones and also the type of cop car (LA,SF or LV) if there is no zone, it spawns the country cop car. The last value is always UNUSED for zones controlling the island-ID's. Normally you have all zone-names stored in the <code>map.zon</code> and the island-boundary-zones with their ID's in the map.zon. The last number is the Island-ID.
 +
There is a zone of this zone type hardcoded into the game that would have an entry similar to this line:
 +
 
 +
{{Pre|
 +
THEMAP 3 -3000.0 -3000.0 -2000.0 3000.0 3000.0 2000.0 0 UNUSED
 +
}}
 +
 
 +
You can lock/unlock them using SCM.
 +
 
 +
===GTA IV===
 +
[[GTA IV]] uses the same format like San Andreas, but the section identifier has been changed to '''mzon''' for type 0.
 +
 
 +
{{Incomplete}}
 +
 
 +
==Tools==
 +
* {{Icon|3}} {{Icon|VC}} [[KEd]] by {{U|JernejL}}, can only view zones
 +
 
 +
==External links==
 +
* {{GTAF|140597|Map File Definitions}}
 +
* {{GTAF|410193|SA Zon script for 3DMax}}, by {{U|Jost_Vice}}
 +
* {{GTAF|218318|Map IO in Kams script pack}}, by {{U|Kam}}
 +
* {{GTAF|402942|(SA and IV) Zon-IO in GTA-IV script centre}}, by {{U|Gforce}}
 +
* [http://pdescobar.home.comcast.net/~pdescobar/tmp/zone_mapper.png San Andreas' info.zon map], by pdescobar
 +
 
 +
{{N|4|LCS|SA|VC|3}}
 +
 
 +
[[Category:Map Formats]][[Category:GTA VCS]]

Latest revision as of 18:49, 11 July 2020

ZONE (IPL section)
Supported games:GTA III Vice City San Andreas Liberty City Stories Vice City Stories GTA IV
IPL Sections:
2DFX • AUZO • BLOK • CARS • CULL • ENEX • GRGE
INST • JUMP • LINK • LODM • MLO+ • MULT • OCCL
PATH • PICK • RTFX • SLOW • TCYC • VNOD • ZONE

ZONE is a section in the item placement file in GTA III, Vice City, San Andreas, Liberty City Stories, Vice City Stories, and GTA IV. It creates an area in the game used to show the text of the zone being entered, to load islands, and to create locations to spawn specific vehicles and pedestrians. The section is mainly placed in .zon files, which use the IPL format, but it can also be placed in .ipl files.

Format

zone
# III/VC/SA
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Level
# IV
Name, Type, X1, Y1, Z1, X2, Y2, Z2, Level, Text
end
GTA III Vice City San Andreas GTA IV Identifier Type Description
A Name string Name and text of zone used from the .gxt file. Stick to 7 char max
B Type integer Type of zone (see below)
C,D,E X1, Y1, Z1 float[3] A point which corresponds to the corner of the box, usually the lower left
F,G,H X2, Y2, Z2 float[3] A point which corresponds to the opposite corner of the box, usually the upper right
I Level integer The level number (see below)
- J Text string Text of the zone used from the GXT file

Note that for San Andreas, the text of the zone to be displayed is also related to by an internally hardcoded table which links that zone name to its respective audio description for the police radio. This is actually the cause of a bug in the game - the zone 'SUN' (which is correctly named 'Temple' in the GXT file) gets announced as 'Sunnyside' on the police radio. This is because the internal table has two consecutive entries called 'SUN' and only the second one gets used, meaning whenever the player is in a zone named and defined as 'SUN' in this file, the police will always announce this as 'Sunnyside' since 'SUN' points to that audio entry.

Major files

Most of these zone files are saved into the game save so any changes made to these files require starting a new game.

GTA III

A map of GTA III's gta3.zon areas, including the hardcoded CITYZON area
  • Level number 1: Portland
  • Level number 2: Staunton
  • Level number 3: Shoreside Vale

gta3.zon

  • Type: 0, 1, or 2

The gta3.zon controls the text of the zone that shows up in the game as you enter a new zone. The original main.scm uses this file throughout the script so you cannot simply delete the lines in the file to prevent the zone's text from popping up in the game without editing the script file. The script file uses this to control how cars, peds, and gangs spawn in the map, and to check if you are inside the zone. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line: 

CITYZON 0 -4000.0 -4000.0 -500.0 4000.0 4000.0 500.0 0

map.zon

  • Type: 3

The map.zon controls the loading of an entire island as you travel from one island to another. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line: 

THEMAP 3 -4000.0 -4000.0 -500.0 4000.0 4000.0 500.0 0

Vice City

A map of Vice City's info.zon areas, including the hardcoded CITYINF area
A map of Vice City's navig.zon areas, including the hardcoded VICE_C area
  • Level number 1: Vice City Beach
  • Level number 2: Vice City Mainland

info.zon

  • Type: 2

The info.zon, with the help of the main.scm, controls how cars, peds, and gangs spawn in the map. The original main.scm uses this file throughout the script so you cannot simply delete the lines in the file without editing the script file. This zone uses level number 1. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line: 

CITYINF 2 -2400.0 -2000.0 -500.0 1600.0 2000.0 500.0 0

map.zon

  • Type: 3

The map.zon controls the loading of an entire island as you travel from one island to another. You can disable the loading of the islands by deleting the entire section. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line: 

THEMAP 3 -2400.0 -2000.0 -500.0 1600.0 2000.0 500.0 0

navig.zon

  • Type: 0 or 1

The navig.zon controls the text of the zone that shows up in the game as you enter a new zone. A zone of type 1 means that the text of that zone will take priority if there are more than one overlapping zones (Junk Yard over Escobar International in this case). There is a zone of this zone type hardcoded into the game that would have an entry similar to this line: 

VICE_C 0 -2400.0 -2000.0 -500.0 1600.0 2000.0 500.0 0

The original main.scm uses this file throughout the script so you cannot simply delete the lines in the file to prevent the zone's text from popping up in the game without editing the script file. The script file uses this to check if you are inside the zone. This zone generally used level number 1 but that column does not seem to have any effect.

San Andreas

  • Level number 1: Los Santos
  • Level number 2: San Fierro
  • Level number 3: Las Venturas

Info.zon

  • Type: 0

The Info.zon controls the text of the zone that shows up in the game as you enter a new zone. It also controls which pedestrian and vehicles spawn in that specific zone, with the help of the main.scm. The main.scm uses this file so you cannot just delete the lines in the file to prevent the zone's text from popping up in the game without editing the main.scm. This zone uses level number 1 only.

Map.zon

A map of San Andreas' map.zon areas, including the hardcoded THEMAP area
  • Type: 3

The map.zon controls the island zones and also the type of cop car (LA,SF or LV) if there is no zone, it spawns the country cop car. The last value is always UNUSED for zones controlling the island-ID's. Normally you have all zone-names stored in the map.zon and the island-boundary-zones with their ID's in the map.zon. The last number is the Island-ID. There is a zone of this zone type hardcoded into the game that would have an entry similar to this line: 

THEMAP 3 -3000.0 -3000.0 -2000.0 3000.0 3000.0 2000.0 0 UNUSED

You can lock/unlock them using SCM.

GTA IV

GTA IV uses the same format like San Andreas, but the section identifier has been changed to mzon for type 0.

This section is incomplete. You can help by fixing and expanding it.

Tools

External links

v · d · e
GTA IV Grand Theft Auto IV
File Formats.dat • .gxt • .ide • .img • .ipl • .nod • .sco • .rpf • .rrr • .wad • .wbd/.wbn • .wdd • .wdr • .wft • .whm • .wpl • .wtd
DocumentationAudio • Bink Video • Cryptography • Cutscenes • GXT Text • Image listing • Keycodes • Map Listing • Native functions • Paths • Radar Blips • Radio Stations • Saves • Scenarios • VTable • Weapons
ToolsASI Loader • ENBSeries • G-Texture • GIMS IV • Ingame WPL Editor • IV Needle • OpenIV • SparkIV • XLiveLess • WPL Manager • X Mod Installer
Alice • C++ Script Hook • .NET Script Hook • Scocl
TutorialsImporting Textures with OpenIV • Importing Textures with SparkIV
ModificationsGostown IV • Four Multiplayer • IV Multiplayer • CitizenMP:IV Reloaded
Useful linksCommunity portal • Discussion forums • Modding forums • Mods on GTAGarage.com
v · d · e
Liberty City Stories Grand Theft Auto: Liberty City Stories
File Formats.cfg • .chk • .dat • .dtz • .gxt • .ide • .img • .ipl • .mdl • .pss • .scm • .vb
DocumentationLeeds Engine • Opcodes • Radio Stations • Saves • Scrollbar • Vehicles
ToolsSanny Builder
Useful LinksCommunity Portal • Discussion Forum • Modding Topic • Mobile Modding
v · d · e
San Andreas Grand Theft Auto: San Andreas
File Formats.b • .col • .cfg • .cut • .dff • .dat • .fxp • .gxt • .ide • .ifp • .img • .ipl • nodes*.dat • .ped • .rep • .rrr • .scm • .set • .txd
DocumentationAudio • Cryptography • Cutscenes • Game memory • Handling.cfg • Map Listing • Mission Packs • Instructions • Paths • Replays • Saves • Scripts • Sound Effects • Statistics • Vehicles • Wanted levels
ToolsCLEO • Collision File Editor II • ENBSeries • G-Tools • IMG Tool • Limit Adjuster • Map Editor • Mod Loader • San Andreas Audio Toolkit • Sanny Builder • TXD Workshop • Magic.TXD
TutorialsSan Andreas v2.0 Modding • How to create a mission • How to create a script • How to use Map Editor • Vehicle Mod Installation
ModificationsDesign Your Own Mission • Gostown Paradise • GTA: United • Myriad Islands
MultiplayergtaTournament • Multi Theft Auto • San Andreas Multiplayer • (more...)
Useful linksCommunity Portal • Discussion Forums • Modding Forums • Mods on GTAGarage.com • Mobile Modding • Opcodes Database
v · d · e
Vice City Grand Theft Auto: Vice City
File Formats.adf • .b • .col • .cfg • .dff • .dat • .gxt • .ide • .ifp • .img/.dir • .ipl • .raw/.sdt • .rep • .set • .scm • .txd
DocumentationAudio • Handling • Map Listing • Memory Addresses • Skin List • Opcodes • RenderWare • Script Paths • Saves • Sound Effects • Statistics • Vehicles • Text • Wanted levels • Weapons
ToolsCLEO • Collision File Editor II • G-Tools • GXT Editor • IMG Tool • Limit Adjuster • KEd (map editor) • Sanny Builder • TXD Workshop • Magic.TXD
TutorialsHow to create a mission • How to create a script • Vehicle Mod Installation
MultiplayerGTA:LC Multiplayer • gtaTournament • Multi Theft Auto • State Of Liberty Online • Vice City Multiplayer • Vice City Online
Useful linksCommunity Portal • Discussion Forums • Modding Forums • Mods on GTAGarage.com • Mobile Modding • Opcodes Database
v · d · e
GTA III Grand Theft Auto III
File Formats.b • .col • .cfg • .dff • .dat • .gxt • .ide • .ifp • .img • .ipl • .raw/.sdt • .set • .scm • .txd
DocumentationAudio • Handling.cfg • Map Listing • Opcodes • Paths • RenderWare • Saves • Sound Effects • Statistics • Vehicles • Wanted levels • Weapons
ToolsCLEO • Collision File Editor II • G-Tools • IMG Tool • Map Editor • Sanny Builder • TXD Workshop • Magic.TXD • Water Editor
TutorialsHow to create a mission • How to create a script • How to use Map Editor • Vehicle Mod Installation
MultiplayerLiberty Unleashed • Multi Theft Auto • More...
Useful linksCommunity Portal • Discussion Forums • Modding Forums • Mods on GTAGarage.com • Mobile Modding • Opcodes Database
Retrieved from "https://gtamods.com/mediawiki/index.php?title=ZONE&oldid=18155"