Jobs file (X3)
From X-Wiki
Structure of Jobs T file:
Contents |
Understanding Jobs
The Jobs and Jobwings files are responsable for creating, placing, replacing, and controlling the behavior of most of the ships in the X-Universe. This author does not believe that these file spawn and control ships owned and used by AI stations, but is not sure. All of the millitary patrols, pirate patrols, civilians, and general traders are spawned and controlled here.
Data Structure
Version 1.4.03
| Field | Description |
|---|---|
| 0. JobID | |
| 1. Comment | |
| 2. Quota | |
| 3. Max. quota per sector | |
| 4. Function | |
| 5. Config script | |
| 6. Job Text ID | |
| 7. Unique ship name | |
| 8. Overriden name ID (voice) | |
| 9. Show race name | |
| 10. Show company name | |
| 11. Show ship type name | |
| 12. Show variation name | |
| 13. Job Wings group ID | Index to JobWings file |
| 14. Shopping basket | Index to WareLists file |
| 15. Jump range | |
| 16. Idle rate | |
| 17. Respawn time | |
| 18. Ship subtype | |
| 19. M1 | |
| 20. M2 | |
| 21. M3 | |
| 22. M4 | |
| 23. M5 | |
| 24. M6 | |
| 25. TP | |
| 26. TS | |
| 27. TL | |
| 28. Argon | Race Argon |
| 29. Boron | Race Boron |
| 30. Split | Race Split |
| 31. Paranid | Race Paranid |
| 32. Teladi | Race Teladi |
| 33. Xenon | Race Xenon |
| 34. Pirate | Race Pirate |
| 35. Khaak | Race Kha'ak |
| 36. Goner | Race Goner |
| 37. Yaki | Race Yaki |
| 38. VAR 0 | Basic |
| 39. VAR 1 | Vanguard |
| 40. VAR 2 | Sentinel |
| 41. VAR 3 | Raider |
| 42. VAR 4 | Hauler |
| 43. VAR 5 | Miner |
| 44. VAR 6 | Super Freighter |
| 45. VAR 7 | Tanker |
| 46. VAR 8 | Tug |
| 47. VAR 9 | Luxury Cruiser |
| 48. VAR 10 | Slave Transport |
| 49. VAR 11 | Military Transport |
| 50. VAR 12 | XL |
| 51. VAR 13 | Extended |
| 52. VAR 14 | Tanker2 |
| 53. VAR 15 | Superfreighter2 |
| 54. Hue modifier | |
| 55. Saturation modifier | |
| 56. Chance ship type race is random | |
| 57. Is owner sector | |
| 58. Is core | |
| 59. Has shipyard | |
| 60. Has owner stations | |
| 61. Is not enemy sector | |
| 62. Is border sector | |
| 63. Inverse sector flags | |
| 64. Sector X | |
| 65. Sector Y | |
| 66. Create in shipyard | |
| 67. Create in gate | |
| 68. Create inside sector | |
| 69. Create outside sector | |
| 70. Create NULL | |
| 71. Chance ship is docked | |
| 72. Reserved | For future use |
| 73. Cargo bay extensions | |
| 74. Engine tunning | |
| 75. Rudder tunning | |
| 76. Rotation acceleration limit | |
| 77. Argon | Pilot Argon |
| 78. Boron | Pilot Boron |
| 79. Split | Pilot Split |
| 80. Paranid | Pilot Paranid |
| 81. Teladi | Pilot Teladi |
| 82. Xenon | Pilot Xenon |
| 83. Khaak | Pilot Kha'ak |
| 84. Goner | Pilot Goner |
| 85. Yaki | Pilot Yaki |
| 86. Pirate | Pilot Pirate |
| 87. Shield | |
| 88. Laser | |
| 89. Use drones | |
| 90. Not use IRE | |
| 91. Not use PAC | |
| 92. Not use HEPT | |
| 93. Not use PPC | |
| 94. Not use KE | |
| 95. Use Mass driver | |
| 96. Use PSG (wide area) | |
| 97. Use Ion Disruptor | |
| 98. Use Flak | |
| 99. Use IH | |
| 100. Use Mining | |
| 101. Use Tug | |
| 102. Use Repairlaser | |
| 103. Select weapons | |
| 104. Trade skill | |
| 105. Agression | |
| 106. Morale | |
| 107. Fight skill | |
| 108. NPC ID | |
| 109. Is invincible | |
| 110. Is hidden pirate | |
| 111. Destory OOS | |
| 112. Rebuild select new sector | |
| 113. Fly with average speed | |
| 114. Military | |
| 115. Trader | |
| 116. Civilist | |
| 117. Fighter |
Version 2.0.01
| Field | Description |
|---|---|
| 0. JobID | |
| 1. Comment | |
| 2. Quota | |
| 3. Max. quota per sector | |
| 4. Function | |
| 5. Config script | |
| 6. Job Text ID | |
| 7. Unique ship name | |
| 8. Overriden name ID (voice) | |
| 9. Show race name | |
| 10. Show company name | |
| 11. Show ship type name | |
| 12. Show variation name | |
| 13. Job Wings group ID | Index to JobWings file |
| 14. Shopping basket | Index to WareLists file |
| 15. Jump range | |
| 16. Idle rate | |
| 17. Respawn time | |
| 18. Ship subtype | |
| 19. M1 | |
| 20. M2 | |
| 21. M3 | |
| 22. M4 | |
| 23. M5 | |
| 24. M6 | |
| 25. TP | |
| 26. TS | |
| 27. TL | |
| 28. Argon | Race Argon |
| 29. Boron | Race Boron |
| 30. Split | Race Split |
| 31. Paranid | Race Paranid |
| 32. Teladi | Race Teladi |
| 33. Xenon | Race Xenon |
| 34. Pirate | Race Pirate |
| 35. Khaak | Race Kha'ak |
| 36. Goner | Race Goner |
| 37. Yaki | Race Yaki |
| 38. VAR 0 | Basic |
| 39. VAR 1 | Vanguard |
| 40. VAR 2 | Sentinel |
| 41. VAR 3 | Raider |
| 42. VAR 4 | Hauler |
| 43. VAR 5 | Miner |
| 44. VAR 6 | Super Freighter |
| 45. VAR 7 | Tanker |
| 46. VAR 8 | Tug |
| 47. VAR 9 | Luxury Cruiser |
| 48. VAR 10 | Slave Transport |
| 49. VAR 11 | Military Transport |
| 50. VAR 12 | XL |
| 51. VAR 13 | Extended |
| 52. VAR 14 | Tanker2 |
| 53. VAR 15 | Superfreighter2 |
| 54. VAR 16 | M3+ |
| 55. Hue modifier | |
| 56. Saturation modifier | |
| 57. Chance ship type race is random | |
| 58. Is owner sector | |
| 59. Is core | |
| 60. Has shipyard | |
| 61. Has owner stations | |
| 62. Is not enemy sector | |
| 63. Is border sector | |
| 64. Inverse sector flags | |
| 65. Sector X | |
| 66. Sector Y | |
| 67. Create in shipyard | |
| 68. Create in gate | |
| 69. Create inside sector | |
| 70. Create outside sector | |
| 71. Create NULL | |
| 72. Chance ship is docked | |
| 73. Reserved | For future use |
| 74. Cargo bay extensions | |
| 75. Engine tunning | |
| 76. Rudder tunning | |
| 77. Rotation acceleration limit | |
| 78. Argon | Pilot Argon |
| 79. Boron | Pilot Boron |
| 80. Split | Pilot Split |
| 81. Paranid | Pilot Paranid |
| 82. Teladi | Pilot Teladi |
| 83. Xenon | Pilot Xenon |
| 84. Khaak | Pilot Kha'ak |
| 85. Goner | Pilot Goner |
| 86. Yaki | Pilot Yaki |
| 87. Pirate | Pilot Pirate |
| 88. Shield | |
| 89. Laser | |
| 90. Use drones | |
| 91. Not use IRE | |
| 92. Not use PAC | |
| 93. Not use HEPT | |
| 94. Not use PPC | |
| 95. Not use KE | |
| 96. Use Mass driver | |
| 97. Use PSG (wide area) | |
| 98. Use Ion Disruptor | |
| 99. Use Flak | |
| 100. Use IH | |
| 101. Use Mining | |
| 102. Use Tug | |
| 103. Use Repairlaser | |
| 104. Select weapons | |
| 105. Trade skill | |
| 106. Agression | |
| 107. Morale | |
| 108. Fight skill | |
| 109. NPC ID | |
| 110. Is invincible | |
| 111. Is hidden pirate | |
| 112. Destory OOS | |
| 113. Rebuild select new sector | |
| 114. Fly with average speed | |
| 115. Military | |
| 116. Trader | |
| 117. Civilist | |
| 118. Fighter |
Structure Key
There are 2 race sections. The first is the shiptype race - I think they will not spawn unless that race has ALL shiptypes flagged. Otherwise, regardless of the ower race, it will pick randomly from class (m5, TS) and race to yield Demeter, Barracuda, etc.
When spawning a ship, it chooses randomly of the set flags. Thus you can set M3, M4, and M5 and it will be random.
Shopping Basket number is the index to warelists.txt. When the ship is created, this becomes the ship's ware array. Group ID is for followers in jobwings.txt. When the ship is created, the IDs listed in the jobwings.txt reference back to the job ID in jobs.txt. For example, the Argon One spawns with 2 M3s and 7 M5s. The 2 M3s are wingmen since their job script is wing.protect. The 7 M5s are on patrol, they are not wingmen. In turn the 2 M3s each get 1 M3 wingman, and the 7 M5s each get 2 M5 wingmen.
The second is the owner race of the ship. The ORDER of the races are different - as far as I can tell this is the way it should be Idle rate is in ms, spawn rate is in seconds. If Sector X and Y are -1, it will be random based on the flags before it, otherwise the ship will spawn in the sector at the given index. Shield / Laser, Extensions, Agression, Morale, and other chances are in percentages. Destroy OOS I think means that if the ship is somehow lured out of the sector, and it's not supposed to be oos, destroy the ship. It could mean something related to oos combat.
The Invert flag means invert the flags Is Owner Sector through Is Border Sector.
See also
References
- Structure taken from ObjectDB
