DSO遊戲修改詞彙 (不定時更新)

白衣

Modding glossary
) ~; l5 o2 m/ F) WBy Jan Langermann
(DSO Moodding Forum/ Admin)

8 R* V. O+ Z+ B( K( NThis thread is a growing collection of all important terms relevant for modding and scripting. Italicized words are crossreference and explained elsewhere in the list.
; V% ~$ g1 R2 s2 y, y

• A
• B
• C
  • Camera Lib : Collection of helper functions concerning in-game cameras.
  • Coordinates : Within a star system, DSO always uses the same coordinate system:
    The tradestation is at position (0,0,0) and the hypergate is at position (0,0,10000). Most of the action will happen along this path.
    9 h4 B; `( X2 SAlignment is following:
    Assume you are the tradestation and looking at the hypergate.
    $ k. l' i4 o$ {. Y& f5 |/ Z- X is right
    - Y is upwards
    - Z is towards the hypergate
• D
  • DSO : A short for Darkstar One. Another popular one is "DS1".
• E
• F
  • File Extensions
    • .lua file : LUA is the scripting language we use in DSO. All missions are scripted using LUA. See Lua.org for lua basic tutorials and here for a reference of available commands.
    • .bin file : Binary file. This file has been processed so that it is not human-readable anymore. DSO reads them during startup. If it cannot find a .bin file then the associated .ini files are opened and coverted into .bin format. Lua files also get converted into .bin format. The resulting file is the missions.bin.
    • .ini file : Initialization files. They are human-readable. Use a text editor to edit them. They are usually kept within .cpr files
    • .cpr file : A compressed (archive) file. Can be opened using various decompression utilities.
    • .dds file : Direct Draw Surface format. An image format used in DSO for textures and in screens. To make use of them, use either the DirectX Texture tool coming with the DirectX SDK or a plugin for the graphics program of your taste.
      5 d  O% |3 y' kHave a look at those sites:
      MSDN: DXTech - Microsofts DirectX Texture Tool (included in the DirectX SDK)
      MSDN: DDS FileFormat (technical article)
      - P2 n' W6 k: h/ e3 q1 H+ ZMSDN: Using Compressed Textures (technical article)
      $ e% d* C1 }, Y, o7 N: w, t  [DevIL - OpenSource image library, supporting .dds
      NVidia Texture Tools
      ' U3 {4 d: c( @. u8 n: nNVidia .dds - Photoshop PlugIn for .dds
      3DSMax Plugins
      ATI Compressonator
    • .dss file : Our savegame format. Each modification will contain an own set of savegames to avoid confusion. Savegames can be hacked but not modded. We do not provide support for hacked savegames .
• G
  • global.res : A resource file. Contains the strings used by DSO.
• H
• I
  • INI-Files:
    • Upgrades.ini : Contains information about upgrades for the ship.
    • StarSystem.ini : Contains information about every star system in the game.
      Example:
      % `/ L/ ]9 j$ N. x" e2 r6 yCode:
      - S2 w: c4 i) s9 C
      1. [System000] ;
         
      2. Artefakt = 0 ; > 0, if there is an artifact inside the system
         
      3. Bedroht = 0 ; > 0, if occupied by pirates
         ' D5 y, a" p, }3 G, b' F1 \
      4. Bürger = 3.600000 ; population, counted in billions
         
      5. Cluster = 0 ; index of the cluster this system belongs to
         
      6. EnergyLevel = 0 ; determines the type of energy particles floating around
         
      7. Faction = 1 ; pirate system
         
      8. Function_X1 = 0 ; X1 value
         
      9. Function_X2 = 3 ; X2 value
           _+ P3 F. s9 j: j) Q! f( m0 P
      10. Function_X3 = 5 ; X3 value
          3 U* H& v: a- q/ y
      11. Function_Y = 0 ; minimal level
          . g; @' o) E+ ^0 i4 Q# L
      12. NachbarRegel = 10 - 10 ; system becomes visible as soon as one of these systems is entered
          2 v$ h3 v+ F7 \, Z
      13. Piratengang = 65535 ; index of pirate gang
          
      14. Planeten = 2 ; number of planets in system
          
      15. PosX = 4.500000 ; x position on map
          % H6 o& M) ]/ a( j5 E
      16. PosY = 17.799999 ; y position on map
          
      17. Produktion1 = 0 ; coal hydrates
          
      18. Produktion2 = 1 ; proteins
          6 C4 u* x% e, w* O
      19. Produktion3 = 3 ; plants
          
      20. Produktion4 = 12 ; pharma
          
      21. Produktion5 = 23 ; drugs
          
      22. Produktionsfaktor = 0.920000 ; production factor
          ( e% o! @& I: V( z0 _, {
      23. Regierung = 3 ; government
          : J. ^2 s1 _& s+ e! W0 H. f
      24. Sichtbarkeitstyp = 2 ; visibility type (2=made visible by neighbor)
          
      25. StarLightId = 3 ; star light index (3=anarchy)
          
      26. UniqueItem = 0 ; > 0, if an unique item is present

      复制代码
      
      * D' W" k0 O' h8 W! [
      
    • planets.ini : Contains info about all fixed space objects (called "planets" here) in ALL star system.
      ( ~/ o" j7 N- {: c5 X8 a% B0 KCode:
      & P$ q2 h" z* @6 R7 G7 i) T- Q
      1. [Globals] ;
         ; h3 [8 c; V2 E5 k1 b  @* |- I
      2. Planetenanzahl = 5969 ; Number of planets in the whole ini file. May be greater but NOT smaller than the actual count!
         
      3. Sternenanzahl = 403 ; Number of star systems that this ini file has stored planets for. Again, must be at least the actual count!
         
      4. [Planet000_000] ; First index: star system index, second index: planet index within star system
         3 ?* Y) O, j# j7 x
      5. Model = 3 ; Id of the 3D model to show for this orbiter
         
      6. Orbitart = Sonne ; orbiter type ("Sonne" = "Sun")
         
      7. Position = 464831.531250 / 1936431.875000 / 499874.875000 ; X, Y and Z Position in meters.
         
      8. Radius = 20000.000000 ; Radius in meters
         0 y# J8 a/ D, h) e, C
      9. RotationSteps = 0 ; Timesteps needed for a complete rotation about its axis
         6 p2 r+ R. h4 m4 s2 p" m! x6 P  j
      10. SystemId = 0 ; Index of star system this belongs to
          
      11. UmlaufSteps = 0 ; Timesteps for one complete circulation around the central orbiter

      复制代码
      
      (This planet is the central orbiter, so the timesteps are 0 each)
    • darkstarmod.ini : Contains info about the particular DSO mod. One file is needed inside every mod's subdirectory inside the "Customization" directory. Contains two parameters:
      0 ^$ @$ H$ |  Z2 M$ N8 ~/ ]5 d! X! G% lCode:
      / y7 @8 q$ j5 J7 V6 ?- ^
      1. [darkstarmod]
         
      2. mod_name = Modding Tutorial                        ; name of the modification
         
      3. mod_desc = Simple modding example                ; a brief(!) description

      复制代码
      
      % g4 x* L( p4 W8 u% P; v+ w( g
      0 P* R" N3 g, O9 j
• J
• K
• L
• M
  • Model : 3D objects created by a 3D program.
  • Mission : Missions are scripted, not programmed. Thus they can be altered or created without having to recompile the game executable. This makes modding possible. Missions appear at different places in the game. There are terminal missions, missions started by the storyline, missions starting in free space and missions that are always active. More details will follow.
  • Mission Lib : Collection of helper functions not contained in any of the other scripting namespaces.
• N
• O
• P
• Q
• R
• S
  • Script : Missions are scripted using the scripting language LUA. The original retail scripts are converted into the file missions.bin. Sources to them are not public.
  • script event : Also know as trigger. Scripts can react to certain events like destroyed ships, the player entering a system or a timer running down.
  • script function : Scripts can call various functions to interact with the world. Examples are creating wings of ships, giving wings new orders or starting voice messages or cameras.
  • scripting namespaces : Hard-wired code collections available for scripting use. Each does contain a number of useful scripting functions. The namespaces are: math, lua, NStarSystem, NPlayer, NWing, NShip, NGroupAi, NCamera, NComm, NMission, NScript, NWaypoint, NObject, NContainer, NTerminal, NNPC, NGUI, NSound, NVector, NDebug. "math" and "lua" are original lua code collections. More details to follow.
  • stringId : A name for a string that is used by the program instead of the text itself. StringId's are placeholders.
• T
  • Texture : Textures are images applied to a polygon or complete 3D Model. in DSO they are in .dds format.
• U
  • user_strings.xml : Contains additional strings used by a DSO modification. This is human-readable and can be edited by worksheet programs like MS Excel. Needs to be converted into .res format before it can be used. Use the Ascaron delivered tool XML2ResConverter.exe to do so.
  • user_strings.res : A resource file. Contains additional strings used by a DSO modification. Is already converted and ready for use.
• V
• W
  • Wing : A logical group of ships. Contains a wingleader and wingmen. You can only assign orders to the whole group. In DSO all ships are also in a wing, even if there is just one ship inside.
  • Wingleader : Part of a wing. Each wing will have exactly one wingleader. If the wingleader is destroyed, you can rely on the wing having been eliminated.
  • Waypoints : Wings may be ordered to fly to certain positions in space. These are called waypoints. Waypoints are space objects that will trigger a script event if the player or a certain ship comes close enough. They have a position and a given radius. See also coordinates.
• X
  • XML2ResConverter.exe: A tool to convert a user_string.xml to a user_strings.res. It needs to check the global.res to avoid overriding stringId's from the original game content.
• Y
• Z

Still work in progress!
Request a topic and we will try to fill the gaps.
: E% a1 p# Z/ B# Z9 z__________________
Customer Support
, o! y6 h8 V- }* e' N  c; v. r/ u- Y$ B* LMission Scripting Darkstar One
support form

--------------------------------------------------------------------------------
$ q/ o% ]& z- s) c% n# kLast edited by CelAthor : 18.09.2006 at 10:19.

[ 本帖最后由 白衣 于 2007-6-17 19:14 编辑 ]