OniGalore - User contributions [en]

Creating a level

2025-12-26T06:17:28Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{integrate|See {{SectionLink||Forum tutorials on level creation}}.|plural=yes}}
This page covers level creation from scratch. See [[Modifying an existing level]] if you want to change a vanilla level in the game.

==Level releases and resources==
===Fan-made levels===
{| class="wikitable sortable autosort by-column-3"
!Date
!Name
!Level number
|-
|2019/09/16
|[https://web.archive.org/web/20240527004257/http://oniforum.bungie.org/viewtopic.php?id=2965 Omega Tournament]
|31
|-
|2016/02/13
|[https://web.archive.org/web/20160224173743/http://oni.bungie.org/forum/viewtopic.php?id=2947 AI Battle]
|7
|-
|2014/01/19
|[https://web.archive.org/web/20211202225410/http://oni.bungie.org/forum/viewtopic.php?id=2698 Wilderness Preserve]
|17
|-
|2013/09/07
|[https://web.archive.org/web/20201127180732/http://oni.bungie.org/forum/viewtopic.php?id=2656 Island]
|29
|-
|2013/07/12
|[https://web.archive.org/web/20201127175459/http://oni.bungie.org/forum/viewtopic.php?id=2640 City]
|28
|-
|2013/06/01
|[https://web.archive.org/web/20201029102326/http://oni.bungie.org/forum/viewtopic.php?id=2619 Fight Club]
|25
|-
|2012/05/12
|[https://web.archive.org/web/20220701102842/http://oni.bungie.org/forum/viewtopic.php?id=2357 Old China]
|24
|-
|2012/03/18
|[https://web.archive.org/web/20211202220454/http://oni.bungie.org/forum/viewtopic.php?id=2302 Boss Battle]
|23
|-
|2012/02/12
|[https://web.archive.org/web/20201029113554/http://oni.bungie.org/forum/viewtopic.php?id=2271 De Dust Deluxe]
|22
|-
|2012/01/23
|[https://web.archive.org/web/20201029114415/http://oni.bungie.org/forum/viewtopic.php?id=2242 Parkour Challenge 2]
|21
|-
|2012/01/16
|[https://web.archive.org/web/20211205145843/http://oni.bungie.org/forum/viewtopic.php?id=2235 Parkour Challenge]
|21
|-
|2011/07/25
|[https://web.archive.org/web/20201029103607/http://oni.bungie.org/forum/viewtopic.php?id=2001 Mini-Partenon]
|5
|-
|2011/10/03
|[https://web.archive.org/web/20201029113340/http://oni.bungie.org/forum/viewtopic.php?id=2024 Muro's Lair - Preview]
|20
|-
|2011/07/03
|[https://web.archive.org/web/20201029113724/http://oni.bungie.org/forum/viewtopic.php?id=1957 Hexagon]
|16
|-
|2011/06/23
|[https://web.archive.org/web/20201029104928/http://oni.bungie.org/forum/viewtopic.php?id=1938 Junkyard]
|15
|-
|2011/05/01
|[http://mods.oni2.net/node/178 Arena of Hurt (OZG)]
|7
|-
|2010/11/08
|[https://web.archive.org/web/20210117150652/http://oni.bungie.org/forum/viewtopic.php?id=1736 Arena of Hurt (OTA)]
|7
|-
|2010/11/06
|[https://web.archive.org/web/20201029105217/http://oni.bungie.org/forum/viewtopic.php?pid=50565#p50565 Martian Colony] AKA "Silly World"
|5
|-
|2010/02/15
|[https://web.archive.org/web/20201029113916/http://oni.bungie.org/forum/viewtopic.php?id=1506 Maze]
|5
|-
|2008/09/16
|[http://mods.oni2.net/node/4 Arena of Pain]
|30
|-
|2024/05/20
|[https://gamebanana.com/mods/514707 Kitsune: Chapter 1]
|20
|}

===Forum tutorials on level creation===
* '''[https://web.archive.org/web/20201029114347/http://oni.bungie.org/forum/viewtopic.php?id=2087 "Creating the Lair - A level tutorial"]'''
* [https://web.archive.org/web/20201127172559/http://oni.bungie.org/forum/viewtopic.php?pid=53026 "Creating a Custom Oni Level (s10k video tutorials)"]
* [https://web.archive.org/web/20201127180431/http://oni.bungie.org/forum/viewtopic.php?id=1515 "Creating new levels"]
* [https://web.archive.org/web/20201029114358/http://oni.bungie.org/forum/viewtopic.php?pid=33838 "Create levels with pathfinding grids"]
* [https://web.archive.org/web/20210117145338/http://oni.bungie.org/forum/viewtopic.php?id=2000 "More questions about levels"]
* [https://web.archive.org/web/20201029103906/http://oni.bungie.org/forum/viewtopic.php?pid=37252#p37252 "Modding Existing levels - Beta" ("Moveable furniture" post)]

===Wiki pages on level creation===
* [[Creating a level]] (you are here)
* [[Modifying an existing level]]
* [[New levels]] (a historical document)
* [[Lightmapping levels]] (an experiment)

===Free asset sources===
* [https://3dwarehouse.sketchup.com/ 3D Warehouse] – architectural models (also see the [https://3dwarehouse.sketchup.com/collection/236901867937c4ed5fbaf4019d18db23/New-content-for-Oni curated collection] by geyser)
* [https://www.turbosquid.com/ TurboSquid] – various models, including architecture
* [https://www.textures.com Textures.com] – wide variety of textures

==Engine limitations==
First you should be aware of the limitations that Oni will place on your level.

* The triangle limit of a game level is approx. 520,000 (consider it 500,000 to be on the safe side).
* {{ModTool}} can save DAE files with a maximum of 64,000 triangles per object.
* When polygons are too tightly packed, the camera will look at too many of them and glitches will appear. The limit on visible GQs (Gunk Quads) is 8,192 (213), and higher numbers will cause render bugs and produce the console error message "Exceeded max visible GQs ''number''". There are limited solutions to this:
** Decrease the '''gs_farclipplane_set''' value.
** Hide objects via '''[[#.3CModel.3E|env_show]]'''.
** Hide objects by ''level design''. For example, departments in a building could be quite detailed because the view of the other departments/rooms is blocked by walls.
* The camera can look at 2,049 transparent textures at once; one more, and Oni crashes.
* Characters are visible ''only'' within world coordinates {-4,099, -4,099, -4,099} to {4,099, 4,099, 4,099}.
* Geometry stops outside of (roughly) world coordinates -4,228 to 4,228 on the X and Z axes (vertical axis not tested).
* '''chr_debug_spheres = 1''' visualizes the collision spheres of characters, so you can check if they will fit through an entrance.

==3D tools==
===Problems when using multiple different tools===
Re-saving a DAE file in '''Mod Tool''' which was originally made in '''SketchUp''' can result in a surprising change in size within Oni. This is due to a difference in the specification of a scale unit.

: For example, the SketchUp DAE file may have: <tt><unit meter="0.0254000" name="inch" /></tt>
: And the re-saved Mod Tool DAE file may have: <tt><unit meter="0.1" name="decimetre"></unit></tt>

In that case you'll need to open the new DAE in a text editor and change the length specification back.

===Sketchup===
If you are working with Sketchup check out this pages:
* [http://web.archive.org/web/20201029103436/http://oni.bungie.org/forum/viewtopic.php?id=2003 "Sketchup tutorials for making levels"]
* [[SketchUp tutorials and tips]]

===Blender===
'''Scaling'''

Same as Mod Tool and SketchUp: Caution with scaling: See [[#Problems when using multiple different tools|here]]

'''Pathfinding'''

Be sure to uncheck automatic triangle creation when exporting (BNV) geometry used for pathfinding. Ghost (''doors'') must be quads.

==Setting up a workflow==
If not noted differentely you need OniSplit v0.9.82.0 or a newer version. Onisplit can be downloaded [http://mods.oni2.net/node/38 HERE] (it also comes with the [[AE]] and is found in the Tools directory of the installation).

The level import demo files can be downloaded [http://mods.oni2.net/node/299 HERE].

First, put '''OniSplit.exe''' into the second '''lab''' folder alongside the XML files.

Look at the file '''build.cmd'''. These are the two important lines:

OniSplit.exe -create:level out lab.xml
OniSplit.exe -import:pc out level3_Final.dat

The first line creates the *.oni files from a master.xml file, in this case '''lab.xml'''. Once finalized, the resulting .oni files can be put into a new [[Making a mod package|AE package]].

The second line creates level archives which can be used for fast tests. They don't require you to install a package through the AE Installer.

Instead of "-nosep" you can now also use "-pc" for the import. Macs, however, do use "-sep".

==Troubleshooting==
If the game crashes while loading at ~90% progress, be sure that the texture's x and y dimensions are powers of two: 64, 128, 256, 512….

If the game crashes while loading at ~50-60% progress, be sure that the BINACJBOCharacters or AISA file has a player character defined.

If the game crashes while loading ~5-10% progress, check if all your textures were inside the "out" folder.

:You can extract the AKEV file to XML, then search for the [[XML:AKEV#TXMA|TXMP Array]].

:[http://mods.oni2.net/system/files/AKEV_texture_checker.txt THIS] script checks which textures are missing by comparing the AKEV*.xml with its *.oni files folder. Change the two paths so that it works for you: Alt+4, insert code, then F5.

"TXMP_marker_door" and "TXMP_marker_ghost" will be missing in the demo's "out" folder.

You can add this between the other two lines in build.cmd to prevent a crash.
OniSplit.exe -create:txmp out env/markers/*.tga

==Terminology==
;Polygon
:A polygon is a shape defined by points (vertices) in space. Polygons are the most fundamental building block in games. Oni uses only shapes with 3 and 4 points (triangles and quads). Other games might also use N-gons, shapes with more points.
;Face
:The '''surface of a polygon''' is also named face. The '''direction''' of a face in '''defined by its normal'''. If an object seems to have a hole, it might be that the polygon just has a '''flipped normal''' and is therefore wrongly rendered (displayed on screen).
;Normal
:Faces and even vertices themselves have directions. The normals of vertices determine how smooth or sharp edges will appear.
;Vertex (plural<nowiki>:</nowiki> vertices)
:A point within a polygon.
:Vertex colors radiate from one vertex to another vertex, whereby their different color values blend into each other so that gradients can appear.
;Edge
:A line of two points within a polygon.
;Tris (triangles)
:Polygons made of 3 points.
;Quads
:Polygons made of 4 points. Planes. Rectangles.
:Internally, all quads get converted into two triangles and will affect the maximum triangle count accordingly.
;Level
:The term "level" is often used to shorten "level map" (buildings and terrain).
;Geometry
:Level geometry can be objects made of tris and/or quads.
:Oni differentiates between basically 3 types of level geometry:
:* Static objects (sometimes also named AKEV core geometry)
:* Animated objects
:* Pushable objects (not used in the original game)
;Static geometry
:* '''Unique level geometry with no functions''' (AKEV core geometry such as buildings and streets).
:* '''Repeating objects''' are flagged as '''furniture ([[Creating_a_level#Furniture.xml|FURN]])''' although they can be outdoor objects such as boxes and containers. FURN objects were used to be imported by an object collection, an CJBO. Nowadays, furniture collections can be used (again) for imports, but the individual objects are stored as [[XML:OFGA|OFGA]] files. This modularity is known in many game editors (like the Unreal Engine Editor). So, '''OFGA are nothing else than "game assets".''' The drawback of OFGA is that they '''will not import with any vertex shading'''. Only their '''geometries''', attached '''particle''' and '''gunk flags''' get copied into final (baked) level geometry.
:* '''Objects with actual functions''': [[XML:BINA/OBJC/CONS|CONS]], [[XML:BINA/OBJC/DOOR|DOOR]], [[XML:BINA/OBJC/TRIG|TRIG]], [[XML:BINA/OBJC/TURR|TURR]]
;[[XML:AKEV#AGQG|Gunk flags]]
:Properties directly associated with the polygons. Among others, these can be: Transparent, TwoSided, NoCollision, Invisible, NoObjectCollision, NoCharacterCollision, NoDecals, Furniture, Impassable.
;Baking
:When a level gets baked, all geometries get merged.
:*Unique level geometry will have vertex painting.
:*Objects derived from already compiled oni-files (shared classes) will have no vertex painting.
:*Animated and pushable objects will have no vertex shading.
;Vertex shading
:Vertex colors (vector data) can be painted onto core geometry.
:They are used as a rudimentary form of lightmapping (pixel data).
:Having vertex shading is still better than having no vertex shading at all. It makes the level appear more lifelike.
;Lightmapping
:In other games, lights and shadows are added to level geometry with lightmapping.
:There were experiments to bring lightmaps back to Oni. The technique come with a major drawback though. It doubles the triangle count and adds many textures.
;In-game
:When you are "inside" the game, running or playing it.

==Level construction==
'''Visible environment'''
* A '''level map''' consists of visible geometry: terrain and buildings. This is also named the '''environment''' or for short '''env'''.
** Use '''quads''' of approximately 10 up to 20 meters in size to construct env geometry.
* Anything other than floors and simple walls will be made of triangles.
** Geometry from CJBO works best with triangles. Quads might show holes in-game.
'''Invisible pathfinding'''
* '''AIs''' (or non-player characters, NPCs) need '''pathfinding''' data, usually shortened as '''bnv'''.
** Pathfinding data can be described as geometry, therefore as rooms. These '''bnv rooms''' are made of '''floors''' and are connected by '''ghost''' quads which work like doors. AIs can move from one room to another room only by passing a ghost. Therefore, ghosts have the same width as rooms in open terrain.
*** Use floor quads of approximately 10 meters in size to construct BNV floors.
*** Put ghost quads exactly on the edges of BNV floors with an angle of 90 degree.
'''Support for [[XML:BINA/ONIE|effects]]'''
* Effects such as decals that indicate damaged environment need level textures to be registered in [[XML:BINA/TMBD|TMBD]]. Make sure not to replace existing texture entries but to add your own so that the other levels remain unaffected.
'''Level logic'''

BSL scripts bring levels fully to life. The logic is mostly event driven whereby different checkpoints and conditions must be reached.
* Checkpoints are actually [[XML:BINA/OBJC/TRGV|trigger volumes]] that can recognize entering and exiting characters.
* The second most important source of events are [[XML:BINA/OBJC/CHAR|character (script) functions]], especially the die function of enemies.
** To support good and less good players alike, NPC characters can feature the UpgradeDifficulty flag. Also, BSL scripts can detect the current [[BSL:Game_status|difficulty level]].
* [[XML:BINA/OBJC/TRIG|Laser triggers]] are mostly used to control [[XML:BINA/OBJC/TURR|turrets]]. [[XML:BINA/OBJC/CONS|Consoles]], triggers and [[XML:DOOR|door]] unlocking are used to set up very simple "riddles”.
* The creation of cut scenes is time-consuming quality work. Due to missing tools for streamlined workflows, it is totally okay for you to skip this.
** New synchronized FILM, OBAN and TRAM files are required for cut scenes. Not to mention sound files for dialog.

==The master XML file==
''The project file for level creation.''

The '''master XML''' file's '''name determines''' the '''BSL folder name''' and the '''AKEV and ONLV file names''' in the output folder. File paths in the XML can be either absolute or relative.

'''Mandatory files''' for level import:
* ''level_environment''.dae
* ''level_bnv''.dae
* ''level_textures.tga/jpg/png''
* Character.xml or AISA with player
* ONSK name in <Sky> (in Windows, this can be a fake name; does the Mac need actual ONSK files?)
* ONLD file for the new level; read [[Making_a_mod_package#Mod_Info.cfg|HERE]] about making sure your level is unlocked (accessible on the Load Game screen)

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
|valign="top"| <Level SharedPath="...">
|valign="top"| link
| The master XML file can link to other XML files. Most of them will be [[OBD:BINA/OBJC#OBJC_types|BINACJBO]] files. The file type is declared inside the file, so the file name itself doesn't have to contain the type. Ergo, "BINACJBOCharacter.xml" can be given a simpler name like "Character.xml".

Some resources used by those XML files can be found in a '''shared''' folder. OniSplit copies textures and "physics" objects into the output folder; furniture objects will be integrated into the AKEV. Unused resources in the shared folder will be ignored. That way the final level archive or AE package contains only the necessary files, saving disk space for the end user.

In the demo are various subfolders in the '''shared''' folder: consoles, doors, furniture, triggers and turrets. These file types do not need their file prefixes: CONS, DOOR, TRIG and OFGA. OniSplit will recognize them nonetheless.

'''Common mistake:'''

A few CJBO files '''need relative paths for resources'''. Inserting only a file name will not work. Let us take consoles for example: A relative path to a console should look like this: "'''consoles/console_data.oni'''". The resources are stored in '''shared/console/''' but since the XML master file points to the starting folder via "../shared", it will be omitted in all actual resource paths. If you need, look into the files of the [http://mods.oni2.net/node/299 demo project "lab"]. '''Doors''' and '''furniture''' also require relative paths.

'''lab/lab.xml'''
<?xml version="1.0" encoding="utf-8" ?>
<Oni>
<Level SharedPath="../shared">
...

'''lab/Console.xml'''
<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Objects>
<CONS Id="4695">
<Header>
<Flags>Gunk</Flags>
<Position>944.1944 -27 29.37764</Position>
<Rotation>3.623707E-05 270 0</Rotation>
</Header>
<OSD>
<Class>consoles/console_data.oni</Class>
...
|-
| <Environment>
| -
|
|-
| <Model>
| -
| Used to import level geometry and static objects. See [[#<Model>|HERE]] for detailed information.
|-
| <Import Path="..."/>
| link
|
|-
| <Node Id="...">
| string
| informational (space for notes)
|-
|valign="top"| <ScriptId>
|valign="top"| integer
| Can be used with BSL commands such as ...
: [[#<Model>|env_show ID 1]] (use 0 to hide)
: [[#Breakable glass with BSL recognition|env_broken ID1 [ID2]]] (if a second ID is supplied then objects in the range ID1..ID2 get counted; "3001 3018" would cover 18 objects)
: [[#Texture exchange|env_texswap ID texture]] (no file prefix/suffix allowed)
: [[#env_shade|env_shade ID ID R G B]]
Static objects store their ID in [[XML:AKEV#IDXA_.28quad_group_id.29|one of AKEV's IDXA instances]].
|-
|valign="top"| <GunkFlags>
|valign="top"| flag
|
;AGQG (Gunk) flags (trimmed list)
see ''OniSplit -help enums'' for more flags
:None
:NoCollision
:NoObjectCollision
:NoCharacterCollision
:NoDecal
:TwoSided
:Invisible
|-
|valign="top"| <Rooms>
|valign="top"| -
| For detailed information see [[#<Rooms>|HERE]].

For a Google SketchUp BNV tutorial see [http://web.archive.org/web/20201029111158/http://oni.bungie.org/forum/viewtopic.php?pid=36760#p36760 HERE].
|-
| <Import Path="..."/>
| link
| File path to *.dae file. BNV data, used to create pathfinding.
|-
| <Textures> {{Anchor|textures_tag}}
| -
| With OniSplit v0.9.94.0+ you can use attributes to set the default import formats and max dimensions. For example:

: <Textures Format="BGR" AlphaFormat="RGBA" MaxSize="512">

Textures with a dimension that isn't a power of two (2x) and textures larger than 512px on a side will be resized. For example, 2003x2000 will become 512x512. (What would 257x255 become?)
|-
| <Texture Name="...">
| string
| TXMP file name to generate.
|-
| <Flags>
| flag
| Optional tag. For list of flags see [[XML:TXMP|HERE]].
|-
|valign="top"| <Format>
|valign="top"| flag
|
:DXT1
:BGR
:RGBA
:BGR555
:BGRA5551
:BGRA4444
|-
|valign="top"| <GunkFlags>
|valign="top"| flag
|
;AGQG (Gunk) flags (trimmed list)
see ''OniSplit -help enums'' for more flags
:None
:NoCollision
:NoObjectCollision
:NoCharacterCollision
:NoDecal
:TwoSided
:Invisible
|-
| <Image>
| link
| File path to *.tga/jpg file.
|-
|valign="top"| <Sky>
|valign="top"| string
| ONSKfile.oni (without file pre- and suffix)

The import doesn't work with an empty tag. <Sky>clear</Sky> helps here; any other fictional name will also do.

For detailed information see [[XML:ONSK|HERE]].
|-
| <Objects>
| -
|
|-
|valign="top"| <Import>
|valign="top"| link
| File path to an OBJC (collection) file. Supported collection files for <Import> are:
: [[XML:BINA/OBJC/CHAR|Character.xml]] (has to contain player character if there's no AISA file with it)
: [[XML:BINA/OBJC/CONS|Console.xml]]
: [[XML:BINA/OBJC/DOOR|Door.xml]]
: [[XML:BINA/OBJC/FLAG|Flag.xml]]
: [[#Furniture.xml|Furniture.xml]]
: [[XML:BINA/OBJC/NEUT|Neutral.xml]]
: [[XML:BINA/OBJC/PART|Particle.xml]]
: [[XML:BINA/OBJC/PATR|PatrolPath.xml]]
: [[#Physics.xml|Physics.xml]]
: [[XML:BINA/OBJC/PWRU|PowerUp.xml]]
: [[XML:SNDD#BINACJBOSound.xml|Sound.xml]]
: [[XML:BINA/OBJC/TRIG|Trigger.xml]]
: [[XML:BINA/OBJC/TRGV|TriggerVolume.xml]]
: [[XML:BINA/OBJC/WEAP|Weapon.xml]]

The following two collection files are '''NOT''' supported. You need to copy them as regular pre-compiled *.oni files into your mod package:
: [[XML:BINA/OBJC/MELE|Melee.xml]] (overrides global MELE; not used in vanilla levels)
: [[XML:BINA/OBJC/CMBT|Combat.xml]] (overrides global CMBT?; not used in vanilla levels)

'''Inside''' the following three supported collection files, provide links to pre-compiled (*.oni) class files: console, door and furniture collections. Use relative paths such as:
:: <code>'''consoles/'''console_data'''.oni'''</code>
:: <code>'''doors/'''TCdouble'''.oni'''</code>
:: <code>'''furniture/'''V_tctf_bigvan'''.oni'''</code>

When you are unsure about the folder structure refer back to the [http://mods.oni2.net/node/299 level import demo].
|-
| <Films>
| -
|
|-
| <Import>
| link
| File path to *.xml file. OniSplit creates a [[XML:FILM|FILM]] file from it. Used for characters in cutscenes.
|-
| <Cameras>
| -
|
|-
| <Camera Path="...">
| link
| File path to *.dae file. OniSplit creates an OBAN file from it. Used for cutscenes.
|-
| <Animation Name="..."/>
| string
| Name for the OBAN file.
|}

This is a trimmed-down version of the master file '''lab.xml''' from the demo. It's meant to give you a first impression. We might upload a smaller demo someday with all features nonetheless.

<?xml version="1.0" encoding="utf-8" ?>
<Oni>
<Level SharedPath="../shared">
<Environment>
<Model>
<Import Path="env/lab_env.dae"/>
<Import Path="env/lab_bomber_window.dae"/>
<Import Path="env/lab_motorcycle.dae">
<Node Id="motorcycle">
<ScriptId>9</ScriptId>
<GunkFlags>NoCollision</GunkFlags>
</Node>
</Import>
</Model>
<Rooms>
<Import Path="env/lab_bnv.dae"/>
</Rooms>
<Textures>
<Texture Name="GOO">
<Format>bgra4444</Format>
<GunkFlags>NoCollision</GunkFlags>
<Image>env/images/GOO.tga</Image>
</Texture>
</Textures>
</Environment>
<Sky>sunset</Sky>
<Objects>
<Import>Character.xml</Import>
<Import>Furniture.xml</Import>
<Import>TriggerVolume.xml</Import>
<Import>Physics.xml</Import>
</Objects>
<Films>
<Import>films/BomberKonRun01.xml</Import>
<Import>films/BomberKonRun02.xml</Import>
</Films>
<Cameras>
<Camera Path="cameras/BomberCam01.dae">
<Animation Name="BomberCam01"/>
</Camera>
<Camera Path="cameras/BomberCam02.dae">
<Animation Name="BomberCam02"/>
</Camera>
</Cameras>
</Level>
</Oni>

===<Model>===
This tag is mandatory (it must be present to avoid errors); the model section contains one import path to the AKEV (level) geometry (*.dae) and can contain additional import paths for exceptions (*.dae).

Data from the demo:

<Import Path="env/lab_env.dae"/>
<Import Path="env/lab_motorcycle.dae">
<Node Id="motorcycle">
<ScriptId>9</ScriptId>
<GunkFlags>NoCollision</GunkFlags>
</Node>
</Import>

'''env_show'''

The motorcycle has here scripting ID 9. You can show and hide the object with the BSL command '''env_show''', where the second parameter means true or false. '''Never use 0 as an ID''' because it won't work.

env_show 9 1
env_show 9 0

EdT demonstrates env_show [https://www.youtube.com/watch?v=Em6wa5JTQNM here]. Note how the objects have collision.

The last vanilla level (Syndicate Mountain Compound) has a big satellite dish platform that can be made hidden. Obviously, such objects/areas can be made to have pathfinding too.

;More possible applications of env_show:
* ground/ceiling/objects for cutscenes that become partially destroyed
* destructible walls like in Deus Ex: Human Revolution (trigger volume, replacing punch anim with punch-through-wall anim)
* grids in front of ventilation shafts (a small door object could be an alternative)
** at the moment this can't be done because characters can't sneak under the top edge of the opening (the characters collision spheres are too big)
* managing object groups with trigger volumes (save multiple objects in one DAE file)



====Import of object groups====
'''Mod Tool versus SketchUp'''

The meaning and behavior of "groups" greatly differs in these two programs.

:'''In SketchUp''' you can group objects which enables you to easily duplicate all objects inside a group and to scale/rotate/translate them all together.

:'''In Mod Tool''' grouped objects are still loose, and duplicating a group won't duplicate the objects. To achieve the same effect as in SketchUp, you have to create a hierarchy where any one object is the "parent" and all others the "children".

'''Google SketchUp'''

To create a group, select two or more objects, right-click on the selection and choose "make group".

[[Image:ModTool_can_import_objs_in_hierarchies.jpg|right|thumb|Mod Tool can import objects in hierarchies to Oni.]]
'''Mod Tool'''

Either use the Explorer (A) or the Schematics (B) to create a hierarchy.

:(A) In the Explorer window, drag and drop one or more objects onto another one.

:(B) Open the constrain tab at the right side. Select parent object, click "Parent", click the child object(s). Check the result in the Schematics window.

:'''Mod Tool: caution when saving to DAE!'''

:A normal selection won't do. You have to select the object tree to successfully save a hierarchy. This is the same way that you do it with Oni characters.


====Breakable glass with BSL recognition====
Broken environmental objects can be recognized by the BSL command ''env_broken (ID_1, ID_N)''. However, this requires additional code to work.

An example is the training level. Let's determine how we can set up such a thing.

First we need a [[XML:BINA/OBJC/TRGV|trigger volume]] like in level 1.

<TRGV Id="11495">
<Header>
<Flags>Locked</Flags>
<Position>-714.6615 -298 -555.2073</Position>
<Rotation>0 0 0</Rotation>
</Header>
<OSD>
<Name>tv75</Name>
<Scripts>
<Entry></Entry>
<Inside>targets_gone</Inside>
<Exit></Exit>
</Scripts>
<Teams>255</Teams>
<Size>400 31 270</Size>
<TriggerVolumeId>75</TriggerVolumeId>
<ParentId>0</ParentId>
<Notes></Notes>
<Flags>PlayerOnly</Flags>
</OSD>
</TRGV>

Now we need some BSL code.

var int inside_target_function;

func void enter_target_function(void)
{
dprint enter_target_function
inside_target_function = 1;
}

func void exit_target_function(void)
{
dprint exit_target_function
inside_target_function = 0;
}

func void targets_are_not_gone(void)
{
# CB: turn off the trigger volume and sleep for a second
# so as not to cause hideous performance loss
trigvolume_enable tv75 0
sleep 60
trigvolume_enable tv75 1
}

func void targets_gone(string ai_name)
{
if (inside_target_function eq 0)
{
enter_target_function() # catch other "targets_gone" functions to let them do nothing

var int num_broken = env_broken(3001, 3018);
# if you only one target use scheme: env_broke(3001, 3001)

if (num_broken eq 18)
{
targets_are_gone();
}

if (num_broken < 18)
{
targets_are_not_gone(); # to set check interval to one second
}

exit_target_function
}
}

func targets_are_gone
{
trigvolume_enable tv75 0
# [...]
}

;Explanation:

Player enters the TV, targets_gone() gets triggered. The variable "inside_target_function" should be 0 by default, so we will enter the "if" block. Next, we can assume that the player didn't destroy all glass objects, so "num_broken" will be less than 18; thus, targets_are_not_gone() gets called.

The TV function targets_gone() ''would'' be triggered every frame, but targets_are_not_gone() creates a delay between checks: the TV gets deactivated for 60 frames. Then the TV becomes enabled again and will start anew until all glass objects got destroyed or player left the TV.

In this case the targets_gone() function will do nothing because "inside_target_function" was set to 1 by the first call.

targets_are_gone() eventually disables the TV to prevent memory overflow; this function also contains all the things ("[...]") that you want to happen after the glass target is broken.

====Texture exchange====
BSL command supported on Windows and Mac:
: env_texswap ID texture

Might be useful to switch on/off static and animated textures. (News broadcast screen: running or off or smashed. Lava stream: flowing or stagnating or cooled down. Etc.)

A similar effect can be achieved by showing/hiding geometries with different textures as EdT has demonstrated in a private test. That way it should also be possible to have different vertex coloring for an area.

====Vertex coloring====
Vertex colors can be edited manually in Blender by setting up following 3 things:
* Properties Panel > Data > Color Attributes
* 3D viewport (left top) > change work mode to Vertex Paint
* 3D viewport (right top) > change to Viewport Shading to Solid mode (under the dropdown menu you can choose "flat" to have full saturation)

{{divhide|Mod Tool}}

[http://web.archive.org/web/20170529111607/http://softimage.wiki.softimage.com/xsidocs/tex_vcolor_CreatingColoratVerticesCAVMaps.htm SoftImage documentation.] Observation: The sniper tower from level 19 Syndicate Mountain Compound can be isolated and re-imported as it is. It will appear quite dark.

If we remove "_color" from the object, the shadows will be gone next time we import the tower.

Mod Tool: Explorer [8]

Object
|
+-- Polygon Mesh
|
+-- Cluster
|
+-- Polygon
| |
| +-- [...]
|
+-- NodeProperties
|
+-- '''_color'''
+-- texcoord (Explicit UVWs)
|
+-- Vertex_Color_Def

So, how do we modify that data?

'''Single object shading'''

If there's already a vertex color property, you can use Shift + W to activate the Paint Vertex Color Tool. With Control + W you can change the brush color. R + Hold Click + Move Mouse let you change the brush size. The more vertices (points) you have, the more detailed you can make the shadows/colors. But keep in mind that too many polygons can destroy collision, making characters fall through the ground.

If there's no vertex color property, the first usage of Shift + W will create that property. But you can also manually create it via Property > Color under Vertices Map.

'''Level-wide shading'''

[[Image:light_test_modtool.png|right|thumb]]
[[Image:light_test_ingame.png|right|thumb]]

To get general shading/lighting you can set up light sources. "Infinite" lights are useful for global lighting, while "Light Box", "Point", "Neon" and "Spot" are more suitable as local light sources. They can be accessed via Primitives > Light.

By default, a Mod Tool scene has one Infinite light, but it doesn't shine in every direction so you might want to add more Infinite lights. Let's say one Infinite light for each direction (+X, -X, +Y, -Y, +Z, -Z) with an intensity of circa 0.25 (night) or 0.75 (day).

The illumination of those lights can be integrated into the vertex color property:
* Property > Color At Vertices Map
* Property > Render Map
* In render map property page, under Sampling select Vertices Only
* Under Surface Color, choose Enable, then in the box below select Vertex _Color; if that option does not appear, click on the New button next to it
* Under Map, select Illumination only
* Finally, click on the button Regenerate Maps...

This must be done for all objects separately.

: [http://mods.oni2.net/system/files/vertex_color_script.txt There's a script here] which can apply vertex color and render maps to all '''selected''' objects. Load it into the script editor with Alt + 4 and hit F5 to run it. (Be sure the script's language was set to VBScript.)
: The variable "overwrite_VC" can be changed.
:: With "1" all existing CAV maps of selected objects will be overwritten. This can take some time.
:: With "0" only selected objects without CAV maps will be the script's target.

'''Notes on ModTool view modes'''
* "Constant" let you see the colors of the vertex coloring only.
* "Textured Decal" let you see object textures only.
* "Shaded" let you see the illumination only.
* "Textured" let you see the textured object with illumination and vertex coloring.
{{divhide|end}}

=====env_shade=====
If you use '''env_shade''', use it with caution. It completely overwrites the vertex coloring.

# BSL command
# env_shade obj_id obj_id R G B

# examples
env_shade 7 7 # object 7 will be black
env_shade 7 7 0 0 0 # object 7 will be black
env_shade 7 7 .31 .999 .5 # object 7 will be quite green
env_shade 7 10 1 1 1 # object 7, 8, 9, 10 lose all their shading

====Baked lightmaps====
A drawback of this method, AKA shadow maps, is the high number of [[XML:BINA/TMBD|TMBD]] changes and new textures for every wall, requiring a lot of memory. How to create shadow maps:

* https://web.archive.org/web/20121105081823/http://www.game-artist.net/forums/support-tech-discussion/5622-burning-shadows-onto-texture-xsi.html


Notes on map options:
* "Surface color and illumination": outputs used texture with added shadows
** Can be used to replace original texture
* "Illumination only": output a texture that only contains the shadows
** Can be used on a new overlying, transparent surface

====Standalone lightmaps====
With this approach there are two meshes, whereby the shadow effects on one mesh get drawn in front of the regular level texture.

Compared to the "baked lightmaps" method, this needs more polygons of course. And these polygons are transparent, which is a problem with Oni's limited rendering ability for such textures. However, standalone lightmaps only need a few new textures if used wisely.

Read [[Lightmapping levels]] to learn more.

[[Image:Oni_Lightmaps_double_polygon_method.jpg|center]]

===<Rooms>===
The Rooms tag is mandatory. It contains an import path to BNV and ghosts (*.dae) which are used to create pathfinding grids. For information on the binary data behind this, see [[OBD:AKVA|HERE]].

Sample code from the master XML file:
<Import Path="env/lab_bnv.dae"/>

'''Fundamentals'''
* '''BNVs''' are '''volumes''' (sometimes also named '''rooms''') that have a pathfinding grid assigned to them.
* For practical reasons you only need '''floors and ramps''' to build a BNV. (As seen [http://edt.oni2.net/images/Hideout_BNV.jpg HERE.])
** A BNV polygon can consist of 3 or more points, but it's recommended to use '''shapes with 4 points''' because the other shapes usually waste more grid space. At the moment you can import only '''[[wikt:convex|convex]]''' shapes.
* Secondly, there are so called '''ghosts''' (vertical quads) that connect '''neighboring BNVs'''. AI can only transit from BNV to another through ghosts.
: OniSplit gives error messages for ghosts that don't have 2 neighboring BNVs, for example:
BNV Builder: Ghost 'grid2' has no adjacencies at <-72,41 1,999 -166,6> and <-71 1,999 -168,21>, ignoring

'''Tolerance values'''
* Horizontal distance from room to ghost: 1
* Vertical distance from room to ghost: 18
* Ghost's horizontal dimension must be greater than 0
* Under optimal circumstances, pathfinding works on a plane that is +4 world units above or -0.5 below the pathfinding grid
* Normally characters can't pass over low vertical walls such as stairs/curbs if those don't have a ramp under them; near ground level (Y=0) is an exception where characters are allowed to step on a plane that is 4 world units above pathfinding grid; higher planes need a ramp
* Maximum angle of ramp you can go on is 70°; higher angles will make characters fall through to their death (in those cases you might want to add invisible walls/boxes to prevent them from touching the ramp)

'''More notes on PF processing'''
* Actually, BNV and ghosts can have any name and don't need any texture.
* During pathfinding calculation, OniSplit creates a new folder called "temp" and a subfolder "grids". There is a file named "''levelname''_grids.dae". That file contains rooms with textures called "bnv_grid_''N''.tga" which mark obstacles in the pathfinding grid. Ghosts will have a transparent texture "'''_marker_ghost'''.tga". You also get these when you export a level. Transparent ghosts make it easier to see the rest of your level if you have many of those planes.
* In Mod Tool, ghosts and rooms can be grouped under a null object. Right-click the null object to select all its children, then use "Selection Only [x]" as your saving option. That way all the planes can be quickly saved to a *.dae file.
* You can influence the pathfinding creation of dangerous zones using danger quads. Read about those [[#Marker textures|HERE]].
* Another kind of influence is the [[#<Model>|gunk flag]] IgnoreGrid. It can be used to tell OniSplit to ignore the object during pathfinding creation. The grids in that place will be white.

[[Image:Pathfinding_grid.jpg|thumb|200px|right|'''ai2_showgrids = 1''' in action]]
'''BSL commands'''
* chr_show_bnv = 1
:: shows number of BNVs the player is standing on
* ai2_showgrids = 1
:: shows pathfinding grids
* ai2_chump
:: spawns a friendly Striker that follows the player if possible, makes also pathfinding grids visible
* ai2_chump_stop = 1
:: Striker stops following you
* ai2_chump_stop = 0
:: Striker follows you again

====Pathfinding on uneven ground====
Pathfinding works on slightly uneven ground as long as the polygons are 0.5 world units beneath or 4 world units above the BNV.

For greater surface irregularities, we can use a trick:
* The problematic polygons must be saved to a DAE file and then referenced in the model section as an individual object.
* Then the <GunkFlags> tag needs to be '''''GridIgnore'''''.
* Additionally we create a plane (invisible if necessary) under the object so that Oni doesn't think there's a hole.
* The ghosts must be taller than the highest polygon to be walked on. (This has been tested up to a height of 2,000 world units.)

'''Symptoms of too-small ghosts'''

A) AI can't run at all.

B) AI loses PF ability if the tracked enemy performs animations that are outside of the pathfinding volume. Here's a video (<nowiki>https://youtu.be/vfKPzP5hiCo</nowiki>, dead link) showing these symptoms.

'''Missing boundaries'''

Let's say you have a BNV, tall ghosts, and a GridIgnore-flagged hill with trees and bushes and stuff.

Why do AIs run up against the trees?
: '''Problem:''' There are no red/orange grids that limit the AI's movement. Normally, objects will produce red pathfinding squares around them. But objects that are 20 world units above the BNV are ignored just like objects with the IgnoreGrid flag.
: '''Solution:''' Add simple geometries like ''_marker_impassable fences'' or danger quads near the BNV.

'''Disappearing AIs'''

The ground is sometimes not solid, and the player and AIs are falling through it.

: '''Problem:''' On GridIgnore-flagged uneven ground, AIs can fall through it when they are out of the player's view.
: '''Solution:''' Use either '''chr_lock_active ''AI_name''''' or '''chr_all_active = 1'''

====Debugging====
'''(OniSplit v0.9.93.0+)'''
[[Image:OniBrowser.jpg|thumb|200px|right|OniBrowser displaying level geometry plus PF and ghosts.]]

* '''env_show_ghostgqs = 1''' makes the ghost quads visible
** The original ghost quads can't be seen; per Neo, "they are not included in the octtree and bsp tree"
** To see them you must use the -debug option in the level creation command (available with OniSplit '''v0.9.93.0+''')
OniSplit.exe -create:level ''output_folder'' '''-debug''' ''input_folder''/''master_xml_file''.xml

Not all debugging/testing needs to be done in Oni. There is also a [http://mods.oni2.net/node/256 program] (Windows only) which can display the whole level.

For example you can load an AKEV*.oni, select the level name, and use the hotkeys [B] and [P] to display BNVs and ghosts.

'''Bug prevention:'''

After all testing is done, you should compile the level a last time without the -debug option.

AIs appear to have trouble shooting through ghost quads that got registered in the octtree/BSP tree as seen here (<nowiki>https://www.youtube.com/watch?v=-ZugVBgBVKc</nowiki>, dead link).

====When OniSplit fails to connect PF quads====
[[Image:Pathfinding_creation__merge_polygons_to_fix_connections.jpg|thumb|200px|right|Fixed PF in compound level after underground construction...]]
It can help to merge polygons to one object and merge their edges. These become white. (Outer edges are blue.)

===<Textures>===
====...used for exceptions====
The [[#textures_tag|textures tag]] is mandatory.

AKEV textures will be imported by the master XML file automatically; you don't need to add them to that file.

: With OniSplit v0.9.82-93.0, the textures' formats will be DXT1 and (for transparent ones) BGRA4444.
: With OniSplit v0.9.94.0+ the textures' formats will be BGR and (for transparent ones) RGBA.

To change the default texture import format, use the Texture'''s''' tag. (Possible with OniSplit v0.9.94.0+.)

To change the format/flag/gunk flag of a specific texture, use the Texture tag.

An example:

<Textures Format="BGR" AlphaFormat="RGBA" MaxSize="512">
<Texture Name="GOO">
<Flags>TwoSided</Flags>
<Format>BGRA4444</Format>
<GunkFlags>NoCollision</GunkFlags>
<Image>env/images/GOO.tga</Image>
</Texture>
</Textures>

* Use the gunk flag "TwoSided" to make surfaces visible from both sides.
* If the texture comes with the gunk flag "NoCollision" then all objects with that texture will have no collision. Characters would fall through it.

Transparency and no collision together would make sense for a water-like substance. The Vago Biotech level uses this approach for the area with green toxic waste.

[[Image:making_a_surface_transparent_and_twosided.png|thumb|200px|right|'''Figure 1''']]

[[Image:AKEV_single_object_multiple_textures.png|thumb|200px|right|'''Figure 2''' one object with multiple textures, one per polygon cluster]]
[[Image:AKEV_single_object_multiple_textures_ingame.png|thumb|200px|right|'''Figure 3''' blue: two-sided glass: two-sided and transparent random metal: no flag (one-sided)]]

'''TwoSided and transparent objects'''

It's also possible to set this in Mod Tool. For TwoSided-ness, use one image source for diffuse and transparency. (It won't work with two image sources even if both sources use the same image.)

For transparency you must additionally use the three checkboxes:
* Transparency: Enable
* Transparency: Use Alpha
* Transparency: Invert

See '''Figure 1'''.

====Regular textures====
OniSplit automatically imports textures of objects in the [[#<Model>|<Model> section]]. Those objects could be considered as AKEV core geometry.

'''One texture per object'''

Furniture and Physics objects are allowed to have only one texture per object. AKEV core geometry can have one texture or multiple textures – that's up to you to decide.

'''Multiple textures per object'''

'''Question:''' How do we apply multiple textures to an AKEV core object?

'''Answer:''' Assuming you are using Mod Tool the procedure will be as follows. Repeat this for each cluster you create (except for projection). See also '''Figure 2 and 3'''.

* Select some polygons
* Go to Material > Phong
* Hit [7] to open Render Tree
* Add a texture and connect "Image" with "Phong", choose "diffuse" as illumination mode
* Double-click "Image" to open Material page
* In the Texture Projection section, click on "New" and choose a suitable projection
** Do this only if there isn't a projection in the "Texture_Coordinates_AUTO" cluster yet
** OniSplit processes only one texture projection, see '''Figure 4'''
* Choose the texture and UV, then fine-tune the UV via Alt + 7

[[Image:AKEV_multiple_textures_one_projection.png|thumb|200px|right|'''Figure 4''' use only one texture projection per object]]

Caution: textures will be fixed to one set of flags. You can't use the same texture A for a one-sided cluster/object B and a two-sided cluster/object C. You would need to create a differently-named clone of that texture and apply that to cluster/object C.

====Marker textures====
Marker textures are used to import certain objects with special flags. Import those objects alongside [[#<Model>|AKEV core]] geometry.

Marker textures aren't imported automatically. Add those textures to the final package or plugin yourself, e.g. with some sort of script.

OniSplit.exe -create:txmp out env/markers/*.tga

The flags Transparent, TwoSided and NoOcclusion are only set if the same texture source is used for diffuse and transparency and if transparency setting are enabled. See the subsection under "[[#...used for exceptions|...used for exceptions]]" called "TwoSided and transparent objects".

'''Danger quads'''

Pathfinding grids have different colored squares with different meanings.
* white/gray - clear space
* green light - near wall
* green - semi-passable
* green dark - stairs
* blue very light - border 1
* blue light - border 2
* blue - border 3
* blue dark - border 4
* '''orange - danger'''
* red - impassable

For detailed information on colors, see [[OBD_talk:AKVA/0x24#EFFECTS_of_various_pathfinding_grid_tile_types|HERE]].

Normally, OniSplit decide how to color the grids. But it's possible to add your own danger quads to fine-tune zones of higher danger. Those orange areas will be generated with the 4 different blue borders around it.

Danger quads must have "'''_marker_danger'''" as texture name.

Results in flags: Transparent TwoSided NoCollision Invisible NoOcclusion Danger

'''_marker_barrier'''


Results in flags: Transparent TwoSided(double-check) Invisible NoObjectCollision NoOcclusion

'''COLLISION (boxes)'''

AIs can get stuck in detailed geometry. This can be prevented with collision boxes. In-game the box will be invisible, but has collision so characters can't get through. The pathfinding grid will be red where it comes in contact with the box; the red is followed by a light green and then regular green.

[[XML:OFGA|OFGAs]] use the COLLISION texture. Onisplit doesn't automatically apply gunk flags to it. You need to use XML tags for that. Typically it would be <GunkFlags>Invisible NoObjectCollision</GunkFlags>

'''Stairs'''

Texture: '''_marker_stairs'''

Normally, characters can't move on stairs because they contain vertical rises. In this case you can use a sloping quad that is above or inside the staircases. It's possible to set the desired flags in the <Model> section, but doing so and exporting these self-made stair ramps is wasted time. Simply apply _marker_stairs to that quad and characters will be able to move on that surface.

Resulting flags: Stairs Transparent TwoSided Invisible NoObjectCollision NoOcclusion

This has no effect on pathfinding creation. Regularly-textured stair geometry (which intersects the marker quad) will be flagged as NoCharacterCollision.

'''Impassable'''

texture: '''_marker_impassable'''

Resulting flags: Transparent TwoSided (<-double-check this) Invisible NoOcclusion

Impassable walls are very similar to collision boxes except that particles can also collide with them. The pathfinding grids will be also red, light green, and green.

'''Blackness a.k.a. jello fix'''

Texture: '''_marker_blackness'''

Resulting flags: TwoSided NoCollision

Simply black walls. No effect on pathfinding creation. The purpose of these walls in Oni is to block out areas outside of a level's outermost wall so that the Jello-cam cannot show the player other parts of the level when it escapes a wall. See [[Jello-cam]] for details.

'''Doors'''

Texture: '''_marker_door'''

Resulting flags: DoorFrame Transparent TwoSided NoCollision NoOcclusion

Don't use this.

===<Objects>===
Information on regular object lists can be looked up here:
: [[XML:BINA/OBJC/CHAR|Character.xml]] (has to contain player character if there's no AISA file with it)
: [[XML:BINA/OBJC/CONS|Console.xml]]
: [[XML:BINA/OBJC/DOOR|Door.xml]]
: [[XML:BINA/OBJC/FLAG|Flag.xml]]
: [[XML:BINA/OBJC/NEUT|Neutral.xml]]
: [[XML:BINA/OBJC/PART|Particle.xml]]
: [[XML:BINA/OBJC/PATR|PatrolPath.xml]]
: [[XML:BINA/OBJC/PWRU|PowerUp.xml]]
: [[XML:SNDD#BINACJBOSound.xml|Sound.xml]]
: [[XML:BINA/OBJC/TRIG|Trigger.xml]]
: [[XML:BINA/OBJC/TRGV|TriggerVolume.xml]]
: [[XML:BINA/OBJC/WEAP|Weapon.xml]]

====Furniture.xml====
The AKEV core geometry is more or less the overall structure of the level while this furniture file adds standard objects (e.g. crates and desks) to it.

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Objects>
| -
| This tag marks the file as BINACJBO.
|-
| <Furniture>
| -
| This tag marks the file as FURN.
|-
| <Header>
|
|
|-
|valign="top"| <Flags>
|valign="top"| flag
| Optional tag. Ignore it. Those flags were used in the past.
:None
:Locked
:PlacedInGame
:Temporary
:Gunk
|-
| <Position>
| float x3
| Optional tag. X Y Z position.
|-
| <Rotation>
| float x3
| Optional tag. X Y Z rotation.
|-
| <OSD>
| -
|
|-
|valign="top"| <Class>
|valign="top"| link
| File path to a '''pre-compiled [[XML:OFGA|OFGA]] (*.oni) file'''. Use it as part of a relative path. Make sure that the OFGA comes with the files it needs: M3GM and TXMP.

An OFGA can hold multiple M3GMs. That 3D content will then be integrated into the AKEV.
|-
|valign="top"| <Particle>
|valign="top"| string
| This name gets written into <Tag> inside ONLV (ENVP section) and can be used with BSL commands, e.g. you can take control over a particle via '''particle BSL_name start'''. For more commands, see [[XML:BINA/OBJC/PART#BSL_support|HERE]].

Take care with the naming of new OFGA files. The particle name will be composed of 2 parts separated by an "_" underscore. When one tag is empty, the final name will contain an underscore nonetheless. '''Examples:'''

: FURN <Particle>test</Particle> + OFGA <Tag>streetlight</Tag> = '''test_streetlight'''
: FURN <Particle></Particle> + OFGA <Tag>streetlight</Tag> = '''_streetlight'''
: FURN <Particle>test</Particle> + OFGA <Tag></Tag> = '''test_'''
|}

;Example

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Objects>
[...]
<Furniture>
<Header>
<Flags>Gunk</Flags>
<Position>-62.692 -29 108.35</Position>
<Rotation>181.522 356.021 178.114</Rotation>
</Header>
<OSD>
<Class>furniture/V_tctf_bigvan.oni</Class>
<Particle></Particle>
</OSD>
</Furniture>
[...]
</Objects>
</Oni>

====Physics.xml====
This file is for objects with "physics". Unlike AKEV core geometry or furniture, these objects can be animated.

: A small video tutorial on [https://www.youtube.com/watch?v=CFNseg_2UxA how to create a simple animated object]

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Physics>
| -
|
|-
| <Object Name="...">
| string
| Use a unique name for each object.
|-
|valign="top"| <ScriptId>
|valign="top"| integer
| Tested with BSL command...
:obj_create ID [ID]
:obj_kill ID [ID]
:env_anim ID [ID]
:env_setanim ID [ID]
The scripting ID will be stored in the ONLV's OBOA instance.
|-
|valign="top"| <Flags>
|valign="top"| flag
|
;Object setup flags
:None
:InUse
:NoCollision
:NoGravity
:FaceCollision
|-
|valign="top"| <Physics>
|valign="top"| flag
| Optional tag for an Object.
:None
:Static
:Linear
:Animated
:Newton (used with <Flags> FaceCollision to [https://www.youtube.com/watch?v=YICB7qugrtc make an object pushable])
:: For a pushable object don't use import sub-tags such as animation name, flags, etc. Just use <Import Path="..." '''/'''> or <Import Url="..." '''/'''>
|-
| <Position>
| float x3
| Optional tag of Object. Only used for non-animated objects. X Y Z position.
|-
| <Rotation>
| float x3
| Optional tag of Object. Only used for non-animated objects. X Y Z rotation.
|-
| <Scale>
| float
| Optional tag of Object. Only used for non-animated objects.
|-
|
<Import Path="...">

<Import Url="...">
|valign="top"| link
|valign="top"| This tag comes in two variants. It doesn't matter what variant you use.
|-
| <Animation Name="...">
| link
| File path to *.dae file.
|-
|valign="top"| <Flags>
|valign="top"| flag
| Optional tag of Animation. For more information on those flags look [[XML:OBAN|OBAN]] page.

;Object animation flags
:None
:Loop
:PingPong
:RandomStart
:AutoStart
:Local
|-
| <End>
| integer
| Optional tag of Animation. Frame number. Used to define the end of an OBAN from a *.dae file.
|-
| <Start>
| integer
| Optional tag of Animation. Frame number. Used to define the start of an OBAN from a *.dae file.
|}

The XML code for physics can be written in two styles.
*The '''first style''' mimics the original structure found in extracted ONLV instances. This makes it '''easier to edit old levels and reimport them''' into the game.
*The '''second style''' was created with structured data (nested objects) in mind and is '''suited for totally new levels''' where animated objects must be created in a 3D editor at first.

'''Code style 1'''

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Physics>
<Object>
<Geometry>M3GMDishBase.oni</Geometry>
<Animation>OBANDishBase.oni</Animation>
<Physics>Animated</Physics>
<ScriptId>201</ScriptId>
<Position>-197.729141 128.46283 -2501.46387</Position>
<Rotation>0.7071067 -1.545431E-08 1.545431E-08 0.7071068</Rotation>
<Scale>2.109375</Scale>
<Name>object_DishBase</Name>
</Object>
</Physics>
</Oni>

'''Code style 2'''
:For documentation purposes, the file here has been trimmed down.

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Physics>
[...]
<Object Name="motorcycle">
<ScriptId>8</ScriptId>
<Flags>FaceCollision</Flags>
<Import Url="motorcycle/export.dae">
<Animation Name="motorcycle02">
<Flags>AutoStart</Flags>
<End>880</End>
</Animation>
<Animation Name="motorcycle02_stop">
<Start>881</Start>
</Animation>
</Import>
</Object>
[...]
</Physics>
</Oni>

In this example, OniSplit takes the file "export.dae", looks at the parts it contains, and creates geometry files from it.
* M3GMhubs_rear.oni
* M3GMhubs.oni
* M3GMmotorcycle.oni
It's convenient that hierarchies are supported here.

The motorcycle is made of 3 parts so 3 object animations ([[XML:OBAN|OBAN]]) will be created up to frame 880. Then OniSplit creates 3 more OBANs starting from frame 881.

The reason for the interruption at frame 880 is probably to give Barabas a little more camera time in the cutscene.

;Notes about BSL usage:

The Vago Lab cutscene script uses the motorcycle objects and animations like this:
env_show 8 0 # hide static motorcycle parts or else they would be visible
env_show 9 0 # while Konoko is still riding her animated motorcycle
env_show 10 0 # the static motorcycle is separated into objects 8, 9 and 10

# Static and animated objects are totally independent from each other.
# They are stored in different arrays so their script IDs can use the same numbers.

obj_create 8 10 # create all animation-ready motorcycle parts
env_anim 8 10 # animate those parts (not necessary if OBAN flag is "AutoStart")

# The first animations would loop because of "AutoStart", so get the
# right timing to apply the other animations. "motorcycle02_stop"
# and the others will not loop because they don't have "AutoStart".
env_setanim 8 hubs_stop
env_setanim 9 hubs_rear_stop
env_setanim 10 motorcycle02_stop

obj_kill 8 10 # delete all animated parts
env_show 9 1 # show static motorcycle model where Konoko parks her bike

====Corpses.xml====
An empty Corpse element (<Corpse />) is treated as unused and placed at the end of the array. If no such empty elements are provided, OniSplit automatically adds 5. OniSplit also ensures that there are at least 20 corpses in the array.

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Corpses>
|
|
|-
|valign="top"| <Corpse>
|valign="top"| -
|
|-
| <Class>
| link
| [[XML:ONCC|ONCC]]''name''
|-
| <Transforms>
| -
| There are 19 <Matrix> for each <Transforms> (which represents a body part).
|-
| <Matrix>
| matrix
| Float 3x3 + float x3 for the last 3 values (X Y Z position). For more information about the matrix, see [[OBD:CRSA]].
|-
| <BoundingBox>
| -
| Bounding box of the whole corpse. Optional; if not provided, OniSplit will generate an approximate one. Currently it doesn't try to locate the ONCC to compute an exact bounding box.
|-
| <Min>
| float x3
|
|-
| <Max>
| float x3
|
|}

'''Trimmed example'''

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Corpses>
<Corpse>
<Class>generic_male_1</Class>
<Transforms>
<Matrix>-0.36488995 0.04620622 -0.9299034 -0.05580434 -0.9980576 -0.02769538 -0.9293768 0.04178688 0.366759717 -215.667755 1.603917 92.85312</Matrix>
<Matrix>0.2961557 -0.185628444 0.936928 -0.368288517 -0.9272724 -0.06730227 0.8812806 -0.32512787 -0.342981815 -216.51889 1.64218426 93.189</Matrix>
<Matrix>0.407847315 0.156575248 0.8995248 -0.238757968 -0.9326179 0.2705892 0.8812805 -0.3251278 -0.342982143 -215.239883 0.8405094 97.23532</Matrix>
<Matrix>0.439697325 0.467113584 0.767118752 0.0248355754 -0.8601105 0.5095029 0.8978026 -0.204975232 -0.389789373 -213.6234 1.46109009 100.80056</Matrix>
<Matrix>0.717241049 -0.179043233 0.673430443 0.4761817 -0.579636 -0.6612664 0.5087397 0.794962764 -0.3304816 -214.81662 1.56564879 92.5172348</Matrix>
<Matrix>0.3398023 0.1672905 0.925498843 0.7910236 -0.5831365 -0.185023025 0.5087395 0.7949628 -0.330481827 -211.71907 0.792413354 95.42558</Matrix>
<Matrix>0.1283634 0.227430075 0.965297 0.804142356 -0.59352535 0.032904774 0.5804117 0.7720126 -0.259073079 -210.372269 1.45546341 99.0937653</Matrix>
<Matrix>-0.285799921 0.06851995 -0.955836535 -0.240357026 -0.970681965 0.00228381017 -0.927656651 0.230394751 0.2938901 -216.284851 1.5839076 91.29168</Matrix>
<Matrix>-0.312039882 0.04875436 -0.948817253 -0.176752359 -0.9842264 0.00755515043 -0.9334825 0.1700632 0.31573534 -216.689789 1.68287766 89.9359055</Matrix>
<Matrix>-0.356412441 -0.5390179 -0.763170958 0.0404523835 -0.82494843 0.5637587 -0.933452547 0.170058519 0.315826446 -217.422012 1.7979821 87.70907</Matrix>
<Matrix>-0.101782769 -0.247171819 -0.9636112 0.5426916 -0.8256094 0.154451028 -0.8337422 -0.507223248 0.2181709 -217.747284 1.30605173 87.0125656</Matrix>
<Matrix>-0.8154478 -0.150626346 0.558888733 -0.1200991 0.9885643 0.09119747 -0.566234052 0.00724477554 -0.8242127 -217.7402 2.065678 88.15346</Matrix>
<Matrix>-0.4593738 -0.326781839 0.825947642 0.8874048 -0.1284554 0.442732215 -0.0385793857 0.9363295 0.348996729 -219.093979 1.81561315 89.08131</Matrix>
<Matrix>-0.9545983 -0.13777709 0.26412034 0.295387268 -0.322961926 0.899134 -0.0385792255 0.9363296 0.348996431 -220.3681 0.9092429 91.37218</Matrix>
<Matrix>-0.9715769 -0.0362956524 0.233924776 0.0276728421 -0.9988148 -0.0400396362 0.2351007 -0.0324283168 0.9714299 -222.775482 0.56178683 92.03825</Matrix>
<Matrix>0.979860842 -0.192433611 0.0533096045 0.193336874 0.9810555 -0.0122905634 -0.0499345176 0.0223497637 0.9985025 -216.8387 1.90143847 87.84845</Matrix>
<Matrix>0.863898 -0.399280578 0.3070101 0.171117 -0.340619326 -0.9244986 0.4737078 0.851207137 -0.225936681 -215.211975 1.58196676 87.93695</Matrix>
<Matrix>0.4673251 -0.0255063027 0.883717656 0.746463835 -0.524209559 -0.4098731 0.4737075 0.851207256 -0.225936785 -212.815842 0.47451216 88.78848</Matrix>
<Matrix>0.216871262 -0.007893051 0.976168454 0.3751846 0.9238389 -0.0758833 -0.9012231 0.3827002 0.203315422 -211.637314 0.410188764 91.0171051</Matrix>
</Transforms>
<BoundingBox>
<Min>-219.731216 -2.258905 84.47974</Min>
<Max>-207.518463 4.49535131 104.023239</Max>
</BoundingBox>
</Corpse>
</Corpses>
</Oni>





[[Category:Modding tutorials]]

Kojiro

2025-12-26T06:17:21Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

__NOTOC__
[[Image:Commguy.jpg|left|150px]]
[[Image:Comguy Render 1.jpg|right|80px]]
'''Kojiro''' is the unofficial name applied by fans to a [[Comm Trooper|Communications Trooper]] associated with [[Muro]] in the first half of Oni (apparently his right-hand man). It can be implied from the dialogue that he is a confident marksman and/or fighter, as well as a highly skilled hacker and communications expert. The fact that he co-leads the raid on [[TCTF HQ]] would make him at least a peer of [[Barabas]].

Despite his importance, he is never named in Oni material, and is merely identified as "Syndicate Henchman" in the subtitles. Coined by Andrashi a.k.a. [[User:Loser|Loser]], the name "Kojiro" was first used in Loser's Warehouse Mod.

==Identification==
Kojiro is commonly identified as "the Comguy with the goggles", i.e. [[ONCC|ONCCcomguy_2]], although this isn't consistent:
*There are several instances of ONCCcomguy_2 that [[Konoko]] can confront and kill, i.e. regular "Comguys with goggles" (without tabi boots, though).
*Sometimes Muro's Comguy doesn't wear goggles, e.g., at the [[ACC|Atmospheric Conversion Center]].

==In-game appearances==
{|align=right
|-
|[[Image:Comm Trooper 2.gif]] [[Image:Comm Trooper 1.gif]]
|}
*In {{C|3}}'s outro (unseen), offering to kill Konoko as Muro's van drives away: "[[Quotes/Speech#Outro_3|Should I take her out?]]"
*In {{C|5}}'s outro (as ONCCcomguy_2), [[Quotes/Speech#Outro_4|talking to Muro]] about how he's been monitoring Konoko during the chase.
*In {{C|6}} (as ONCCcomguy_2), taking part in the raid on TCTF HQ: "[[Quotes/Speech#Syndicate.27s_progress|All units converge.]]"
*In {{C|7}} (as ONCCcomguy_1), standing by Muro's side as Shinatama is being tortured.
*In {{C|8}} (as ONCCcomguy_1), following Muro on his way out of the Atmospheric Conversion Center.
We are not listing appearances of generic goggled Comguys (some of them randomized) or obsolete cutscene material from {{C|4}}.

==Related mods==
===Loser's Warehouse===
Loser's Warehouse is a high-difficulty version of {{C|1}}, with many unexpected challenges (like having to activate the forklift without using the stairs). The boss fight against Kojiro appears at the end of the mod and constitutes one of Loser's first attempts at realistically unforgiving AI. Before the fight, Kojiro introduces himself both by name and as [[Mukade]]'s apprentice. Inspired by the [[Oni2:Truth Number Zero|Truth Number Zero]] hypothesis (or was it the other way around?), Loser's Kojiro fights with [[Ninja]] moves and is able to teleport. At the end of the fight, he says that the only goal of the (very challenging) fight was to hold Konoko back, allowing either for Muro's preparation of the Musashi/Vago operation, or for some other unspecified initiative (Mukade's?).

===Samer's character===
;Playable version
:Kojiro was made into a custom playable character by [[User:Samer|Samer]] and also made part of the [[Saisei Team]]. Mod available [http://web.archive.org/web/20160224195230/http://oni.bungie.org/forum/viewtopic.php?id=1282 HERE].
;NPC and opponent
:The SamMegaPack Conversion mod uses the new Kojiro model in the canonical appearances listed above and in a bonus appearance during the final battle as an additional opponent. The SamMegaPack Conversion is available [http://web.archive.org/web/20211127021652/http://oni.bungie.org/forum/viewtopic.php?id=2467 HERE].

[[Image:Kojiro-mod.jpg|1000px]]

[[Category:Characters]][[Category:Syndicate]][[Category:Modding projects]]

Mod Tool/OniTools addon

2025-12-26T06:17:11Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

OniTools was a level creation addon for {{ModTool}}. It is no longer developed or maintained. Nowadays, modders are expected to use [[Blender]] rather than XSI.

===Download and installation===
Install by dragging and dropping '''[http://mods.oni2.net/node/356 OniTools.xsiaddon]''' into Mod Tool's viewport.

[http://web.archive.org/web/20211128152524/http://oni.bungie.org/forum/viewtopic.php?id=2657 OCF thread]

<gallery>
Image:xsi_addon_weapon_manager.jpg|weapon manager
Image:xsi_addon_powerups_manager.jpg|powerups manager
Image:xsi_addon_flag_manager.jpg| flag manager
Image:xsi_addon_trigger_volume_manager.jpg|trigger volume manager
</gallery>

===Tips===
* while in point (vertex) mode, creating a flag/powerup/TV/weapon will move it to the selected point
* while in object mode, creating a flag/powerup/TV/weapon will spawn it at 0, 0, 0
** check the ''point snap'' checkbox, then use move tool [V] with [Control] to move object to desired point

===Change log===
'''known issues of v7.1.x'''
* FURN particle not yet supported by export
* not compatible with OBJ drag and drop plug-in (it appears to be taken down anyway)

'''known issues of v4-v7'''
* manager windows sometime don't ''update'' what results in another opened instance
* slow flag import, I will probably make the flag numbering (textures) optional in a later version (then turned off by default)
* broken weapon depot update function (temporary solution: delete depot and add all dae file to folder)

----
[[Image:OniTools_select_polygon_find_material_then_delete_all_polygons.jpg|thumb|Material-depending polygon cluster deletion: You need to find the material.]][[Image:OniTools_select_polygon_find_material_then_delete_all_polygons_result.png|thumb|Material-depending polygon cluster deletion: before and after image.]]
'''version 7.1.8'''
* material-depending polygon cluster deletion

'''version 7.1.7'''
* [http://web.archive.org/web/20160225030701/http://oni.bungie.org/forum/viewtopic.php?pid=48310#p48310 Animated Rotoscope]

'''version 7.1.1 - 7.1.6'''
* bug fix: TRGV writing/reading
* [https://www.youtube.com/watch?v=yYHaltepyNI CRSA (corpse array) import]
* scaling support for TRGV
* print absolute position and rotation of selected objects
* print relative position and rotation of selected objects
* furniture library (alpha)
* basic OFGA import / FURN export

'''version 7'''
* a "character export (TRAM)" button (select one bodypart and hit the button, it will select the tree automatically)
* the code includes the "Make Rotation Keys Continuous"
* the addon will change your save file settings (to framerate 60 fps)
: one person can send a new *.exp file and the other person can make a *.dae from it
: old *.exp (that were created based on a 30 fps setting) needs to be [[../#Animating|scaled down]] by a factor of 2
* currently removed the features made in version 6 (hopefully we will not need that any longer)

'''version 6'''

* repair major character rotation flips (beta)
** select a body part and set keyframe range and flip amount
** fine-tune problematic zones by hand

'''version 5'''
* pathfinding manager (alpha: ghosts can be created on edges)
* trigger volume manager (plus BINACJBOTrigger Volume'''.oni''' drag'n'drop support)
* bugfix: flag xml code

'''version 4'''
* flag manager (plus BINACJBOFlag'''.oni''' drag'n'drop support)
* "(un)hide" button works now properly

'''version 3'''
* weapon manager (plus BINACJBOWeapon'''.oni''' drag'n'drop support)
* disables transparency on weapon textures
* button to access OniXSI resources folder
* fixes glitchy PPGs (manager windows sometimes switched from "locked" to "refresh" mode, etc.)

'''version 2'''
* better support for future custom resources (check out the readme files in OniXSI resources folder)
** for example new LSIs can be added at ...\Softimage\Softimage_Mod_Tool_7.5\OniXSI_resources\PowerUps\LSI

'''version 1'''
* powerups manager (plus BINACJBOPowerUp'''.oni''' drag'n'drop support)
** LSIs gets imported with a placeholder geometry (there's no easy way to detect what actual LSI is used for a level)
** using LSIs from the manager works though (just keep in mind that levels are fixed to one type of LSI)
* drag'n'drop support for OniSplit update



[[Category:Outdated modding tools]][[Category:Windows-only modding tools]]

Mod Tool/Oni level rebuilder

2025-12-26T06:17:04Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

[[Image:Mod_Tool_Oni_level_rebuilder_logo.jpg|right]]

;Wouldn't it be nice to have a tool that can rebuild an Oni level?
;Of course after some modification has been made to the level.

Mod Tool and OniSplit could accomplish this task.

===Transfer from Oni to Mod Tool===
Following scenario: A modder drags and drops level1_Final.dat into Mod Tool's viewport.

Mod Tool tells OniSplit to extract needed data.

For example:
:OniSplit.exe -export level0_Final level0.dat
:OniSplit.exe -export level1_Final level1.dat
:OniSplit.exe -extract:dae level1_Final level1_Final/AKEV*.oni -search level0_Final
:OniSplit.exe -extract:xml level1_Final level1_Final/ONLV*.oni
:OniSplit.exe -extract:xml level1_Final level1_Final/BINACJBO*.oni

After that Mod Tool can examine the files and import 3D content on different layers.

: Core geometry: EnvLayer
: Pathfinding: BnvLayer
: Consoles: ConsLayer
: TriggerVolumes: TrgvLayer
: ''etc.''

Also, an already half-filled xml master file can be created.

: The names of BSL folder and skybox can be received from the original ONLV file.

===Transfer from Mod Tool to Oni===
When user is ready he can click import and rebuild the level.

In ideal case he doesn't have to touch the xml master file.

Currently, the xml master file don't seem to cover the CRSA instance.

But, now that Neo has provided a code to create transform matrices, the ONLV file can be post-edited.

Getting the CRSA back into Mod Tool is a bit more complicated, or the code for it, .. like always.

Matrix to euler and back again: [[Mod_Tool/Scripting#Matrix_-.3E_Euler_rotation|see scripting page]].

===Limitations===
Besides the work needed to get this all done ..., cutscenes (animation compositions and FILM creation) and BSL in general won't be produced automatically.

===Realization===
====Export relevant files====
As said before the user will drag and drop a dat file into Mod Tool.

Let's say he drops the airport, the folder will be located at Softimage_Mod_Tool_7.5\OniLevels\level4_Final.

To ensure the AKEV gets all its resources, level0_Final becomes also exported.

Since level0_Final is such a big file, Mod Tool will check if the folder is already located at OniLevels.

For update purposes, the user can force to export level0_Final again by dragging and dropping it into the program.

====Loading work data====
Some content will be imported as it is such as core geometry and BNV.

Other content like consoles should be imported indirectly from CJBO files.

That's necessary because the extracted dae file doesn't cover any flags, script functions, etc.

=====Libraries=====
There's already the shared folder for the xml master file. But we should be able to extend it whenever necessary.

For instance BINACJBOCharacter/AISA/CRSA will require ONCC files in DAE format.

This will be done whenever level0_Final becomes exported.

onisplit -extract:dae level0_Final level0_Final\ONCC*.oni

Inside Mod Tool, envmaps will be disabled so that strange effects with transparency doesn't appear.

====Project management====
Progress must be saved in form of *.exp scene files.

[http://web.archive.org/web/20160224195356/http://oni.bungie.org/forum/viewtopic.php?pid=47612#p47612 Valid project locations] will be provided automatically.

====Alternate management====
There should be a way to let users save their progress when *.exp files don't work.

Also the MergeScene function seems buggy.

: As alternative we can use *.xsi files. These can store custom properties, something that *.dae files can't do.
: It's probably be possible to store all actual content to one *.xsi and store the layer information to one *.xml file.
: Or each layer is stored to one *.xsi file.
: Slower systems might profit from the latter method because the user isn't forced to load everything, he can decide what scene layers he wants.

[[Category:Modding ideas]]

Creating a level

2025-12-26T06:16:56Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{integrate|See {{SectionLink||Forum tutorials on level creation}}.|plural=yes}}
This page covers level creation from scratch. See [[Modifying an existing level]] if you want to change a vanilla level in the game.

==Level releases and resources==
===Fan-made levels===
{| class="wikitable sortable autosort by-column-3"
!Date
!Name
!Level number
|-
|2019/09/16
|[https://web.archive.org/web/20240527004257/http://oniforum.bungie.org/viewtopic.php?id=2965 Omega Tournament]
|31
|-
|2016/02/13
|[https://web.archive.org/web/20160224173743/http://oni.bungie.org/forum/viewtopic.php?id=2947 AI Battle]
|7
|-
|2014/01/19
|[https://web.archive.org/web/20211202225410/http://oni.bungie.org/forum/viewtopic.php?id=2698 Wilderness Preserve]
|17
|-
|2013/09/07
|[https://web.archive.org/web/20201127180732/http://oni.bungie.org/forum/viewtopic.php?id=2656 Island]
|29
|-
|2013/07/12
|[https://web.archive.org/web/20201127175459/http://oni.bungie.org/forum/viewtopic.php?id=2640 City]
|28
|-
|2013/06/01
|[https://web.archive.org/web/20201029102326/http://oni.bungie.org/forum/viewtopic.php?id=2619 Fight Club]
|25
|-
|2012/05/12
|[https://web.archive.org/web/20220701102842/http://oni.bungie.org/forum/viewtopic.php?id=2357 Old China]
|24
|-
|2012/03/18
|[https://web.archive.org/web/20211202220454/http://oni.bungie.org/forum/viewtopic.php?id=2302 Boss Battle]
|23
|-
|2012/02/12
|[https://web.archive.org/web/20201029113554/http://oni.bungie.org/forum/viewtopic.php?id=2271 De Dust Deluxe]
|22
|-
|2012/01/23
|[https://web.archive.org/web/20201029114415/http://oni.bungie.org/forum/viewtopic.php?id=2242 Parkour Challenge 2]
|21
|-
|2012/01/16
|[https://web.archive.org/web/20211205145843/http://oni.bungie.org/forum/viewtopic.php?id=2235 Parkour Challenge]
|21
|-
|2011/07/25
|[https://web.archive.org/web/20201029103607/http://oni.bungie.org/forum/viewtopic.php?id=2001 Mini-Partenon]
|5
|-
|2011/10/03
|[https://web.archive.org/web/20201029113340/http://oni.bungie.org/forum/viewtopic.php?id=2024 Muro's Lair - Preview]
|20
|-
|2011/07/03
|[https://web.archive.org/web/20201029113724/http://oni.bungie.org/forum/viewtopic.php?id=1957 Hexagon]
|16
|-
|2011/06/23
|[https://web.archive.org/web/20201029104928/http://oni.bungie.org/forum/viewtopic.php?id=1938 Junkyard]
|15
|-
|2011/05/01
|[http://mods.oni2.net/node/178 Arena of Hurt (OZG)]
|7
|-
|2010/11/08
|[https://web.archive.org/web/20210117150652/http://oni.bungie.org/forum/viewtopic.php?id=1736 Arena of Hurt (OTA)]
|7
|-
|2010/11/06
|[https://web.archive.org/web/20201029105217/http://oni.bungie.org/forum/viewtopic.php?pid=50565#p50565 Martian Colony] AKA "Silly World"
|5
|-
|2010/02/15
|[https://web.archive.org/web/20201029113916/http://oni.bungie.org/forum/viewtopic.php?id=1506 Maze]
|5
|-
|2008/09/16
|[http://mods.oni2.net/node/4 Arena of Pain]
|30
|-
|2024/05/20
|[https://gamebanana.com/mods/514707 Kitsune: Chapter 1]
|20
|}

===Forum tutorials on level creation===
* '''[https://web.archive.org/web/20201029114347/http://oni.bungie.org/forum/viewtopic.php?id=2087 "Creating the Lair - A level tutorial"]'''
* [https://web.archive.org/web/20201127172559/http://oni.bungie.org/forum/viewtopic.php?pid=53026 "Creating a Custom Oni Level (s10k video tutorials)"]
* [https://web.archive.org/web/20201127180431/http://oni.bungie.org/forum/viewtopic.php?id=1515 "Creating new levels"]
* [https://web.archive.org/web/20201029114358/http://oni.bungie.org/forum/viewtopic.php?pid=33838 "Create levels with pathfinding grids"]
* [https://web.archive.org/web/20210117145338/http://oni.bungie.org/forum/viewtopic.php?id=2000 "More questions about levels"]
* [https://web.archive.org/web/20201029103906/http://oni.bungie.org/forum/viewtopic.php?pid=37252#p37252 "Modding Existing levels - Beta" ("Moveable furniture" post)]

===Wiki pages on level creation===
* [[Creating a level]] (you are here)
* [[Modifying an existing level]]
* [[New levels]] (a historical document)
* [[Lightmapping levels]] (an experiment)

===Free asset sources===
* [https://3dwarehouse.sketchup.com/ 3D Warehouse] – architectural models (also see the [https://3dwarehouse.sketchup.com/collection/236901867937c4ed5fbaf4019d18db23/New-content-for-Oni curated collection] by geyser)
* [https://www.turbosquid.com/ TurboSquid] – various models, including architecture
* [https://www.textures.com Textures.com] – wide variety of textures

==Engine limitations==
First you should be aware of the limitations that Oni will place on your level.

* The triangle limit of a game level is approx. 520,000 (consider it 500,000 to be on the safe side).
* {{ModTool}} can save DAE files with a maximum of 64,000 triangles per object.
* When polygons are too tightly packed, the camera will look at too many of them and glitches will appear. The limit on visible GQs (Gunk Quads) is 8,192 (213), and higher numbers will cause render bugs and produce the console error message "Exceeded max visible GQs ''number''". There are limited solutions to this:
** Decrease the '''gs_farclipplane_set''' value.
** Hide objects via '''[[#.3CModel.3E|env_show]]'''.
** Hide objects by ''level design''. For example, departments in a building could be quite detailed because the view of the other departments/rooms is blocked by walls.
* The camera can look at 2,049 transparent textures at once; one more, and Oni crashes.
* Characters are visible ''only'' within world coordinates {-4,099, -4,099, -4,099} to {4,099, 4,099, 4,099}.
* Geometry stops outside of (roughly) world coordinates -4,228 to 4,228 on the X and Z axes (vertical axis not tested).
* '''chr_debug_spheres = 1''' visualizes the collision spheres of characters, so you can check if they will fit through an entrance.

==3D tools==
===Problems when using multiple different tools===
Re-saving a DAE file in '''Mod Tool''' which was originally made in '''SketchUp''' can result in a surprising change in size within Oni. This is due to a difference in the specification of a scale unit.

: For example, the SketchUp DAE file may have: <tt><unit meter="0.0254000" name="inch" /></tt>
: And the re-saved Mod Tool DAE file may have: <tt><unit meter="0.1" name="decimetre"></unit></tt>

In that case you'll need to open the new DAE in a text editor and change the length specification back.

===Sketchup===
If you are working with Sketchup check out this pages:
* [http://web.archive.org/web/20201029103436/http://oni.bungie.org/forum/viewtopic.php?id=2003 "Sketchup tutorials for making levels"]
* [[SketchUp tutorials and tips]]

===Blender===
'''Scaling'''

Same as Mod Tool and SketchUp: Caution with scaling: See [[#Problems when using multiple different tools|here]]

'''Pathfinding'''

Be sure to uncheck automatic triangle creation when exporting (BNV) geometry used for pathfinding. Ghost (''doors'') must be quads.

==Setting up a workflow==
If not noted differentely you need OniSplit v0.9.82.0 or a newer version. Onisplit can be downloaded [http://mods.oni2.net/node/38 HERE] (it also comes with the [[AE]] and is found in the Tools directory of the installation).

The level import demo files can be downloaded [http://mods.oni2.net/node/299 HERE].

First, put '''OniSplit.exe''' into the second '''lab''' folder alongside the XML files.

Look at the file '''build.cmd'''. These are the two important lines:

OniSplit.exe -create:level out lab.xml
OniSplit.exe -import:pc out level3_Final.dat

The first line creates the *.oni files from a master.xml file, in this case '''lab.xml'''. Once finalized, the resulting .oni files can be put into a new [[Making a mod package|AE package]].

The second line creates level archives which can be used for fast tests. They don't require you to install a package through the AE Installer.

Instead of "-nosep" you can now also use "-pc" for the import. Macs, however, do use "-sep".

==Troubleshooting==
If the game crashes while loading at ~90% progress, be sure that the texture's x and y dimensions are powers of two: 64, 128, 256, 512….

If the game crashes while loading at ~50-60% progress, be sure that the BINACJBOCharacters or AISA file has a player character defined.

If the game crashes while loading ~5-10% progress, check if all your textures were inside the "out" folder.

:You can extract the AKEV file to XML, then search for the [[XML:AKEV#TXMA|TXMP Array]].

:[http://mods.oni2.net/system/files/AKEV_texture_checker.txt THIS] script checks which textures are missing by comparing the AKEV*.xml with its *.oni files folder. Change the two paths so that it works for you: Alt+4, insert code, then F5.

"TXMP_marker_door" and "TXMP_marker_ghost" will be missing in the demo's "out" folder.

You can add this between the other two lines in build.cmd to prevent a crash.
OniSplit.exe -create:txmp out env/markers/*.tga

==Terminology==
;Polygon
:A polygon is a shape defined by points (vertices) in space. Polygons are the most fundamental building block in games. Oni uses only shapes with 3 and 4 points (triangles and quads). Other games might also use N-gons, shapes with more points.
;Face
:The '''surface of a polygon''' is also named face. The '''direction''' of a face in '''defined by its normal'''. If an object seems to have a hole, it might be that the polygon just has a '''flipped normal''' and is therefore wrongly rendered (displayed on screen).
;Normal
:Faces and even vertices themselves have directions. The normals of vertices determine how smooth or sharp edges will appear.
;Vertex (plural<nowiki>:</nowiki> vertices)
:A point within a polygon.
:Vertex colors radiate from one vertex to another vertex, whereby their different color values blend into each other so that gradients can appear.
;Edge
:A line of two points within a polygon.
;Tris (triangles)
:Polygons made of 3 points.
;Quads
:Polygons made of 4 points. Planes. Rectangles.
:Internally, all quads get converted into two triangles and will affect the maximum triangle count accordingly.
;Level
:The term "level" is often used to shorten "level map" (buildings and terrain).
;Geometry
:Level geometry can be objects made of tris and/or quads.
:Oni differentiates between basically 3 types of level geometry:
:* Static objects (sometimes also named AKEV core geometry)
:* Animated objects
:* Pushable objects (not used in the original game)
;Static geometry
:* '''Unique level geometry with no functions''' (AKEV core geometry such as buildings and streets).
:* '''Repeating objects''' are flagged as '''furniture ([[Creating_a_level#Furniture.xml|FURN]])''' although they can be outdoor objects such as boxes and containers. FURN objects were used to be imported by an object collection, an CJBO. Nowadays, furniture collections can be used (again) for imports, but the individual objects are stored as [[XML:OFGA|OFGA]] files. This modularity is known in many game editors (like the Unreal Engine Editor). So, '''OFGA are nothing else than "game assets".''' The drawback of OFGA is that they '''will not import with any vertex shading'''. Only their '''geometries''', attached '''particle''' and '''gunk flags''' get copied into final (baked) level geometry.
:* '''Objects with actual functions''': [[XML:BINA/OBJC/CONS|CONS]], [[XML:BINA/OBJC/DOOR|DOOR]], [[XML:BINA/OBJC/TRIG|TRIG]], [[XML:BINA/OBJC/TURR|TURR]]
;[[XML:AKEV#AGQG|Gunk flags]]
:Properties directly associated with the polygons. Among others, these can be: Transparent, TwoSided, NoCollision, Invisible, NoObjectCollision, NoCharacterCollision, NoDecals, Furniture, Impassable.
;Baking
:When a level gets baked, all geometries get merged.
:*Unique level geometry will have vertex painting.
:*Objects derived from already compiled oni-files (shared classes) will have no vertex painting.
:*Animated and pushable objects will have no vertex shading.
;Vertex shading
:Vertex colors (vector data) can be painted onto core geometry.
:They are used as a rudimentary form of lightmapping (pixel data).
:Having vertex shading is still better than having no vertex shading at all. It makes the level appear more lifelike.
;Lightmapping
:In other games, lights and shadows are added to level geometry with lightmapping.
:There were experiments to bring lightmaps back to Oni. The technique come with a major drawback though. It doubles the triangle count and adds many textures.
;In-game
:When you are "inside" the game, running or playing it.

==Level construction==
'''Visible environment'''
* A '''level map''' consists of visible geometry: terrain and buildings. This is also named the '''environment''' or for short '''env'''.
** Use '''quads''' of approximately 10 up to 20 meters in size to construct env geometry.
* Anything other than floors and simple walls will be made of triangles.
** Geometry from CJBO works best with triangles. Quads might show holes in-game.
'''Invisible pathfinding'''
* '''AIs''' (or non-player characters, NPCs) need '''pathfinding''' data, usually shortened as '''bnv'''.
** Pathfinding data can be described as geometry, therefore as rooms. These '''bnv rooms''' are made of '''floors''' and are connected by '''ghost''' quads which work like doors. AIs can move from one room to another room only by passing a ghost. Therefore, ghosts have the same width as rooms in open terrain.
*** Use floor quads of approximately 10 meters in size to construct BNV floors.
*** Put ghost quads exactly on the edges of BNV floors with an angle of 90 degree.
'''Support for [[XML:BINA/ONIE|effects]]'''
* Effects such as decals that indicate damaged environment need level textures to be registered in [[XML:BINA/TMBD|TMBD]]. Make sure not to replace existing texture entries but to add your own so that the other levels remain unaffected.
'''Level logic'''

BSL scripts bring levels fully to life. The logic is mostly event driven whereby different checkpoints and conditions must be reached.
* Checkpoints are actually [[XML:BINA/OBJC/TRGV|trigger volumes]] that can recognize entering and exiting characters.
* The second most important source of events are [[XML:BINA/OBJC/CHAR|character (script) functions]], especially the die function of enemies.
** To support good and less good players alike, NPC characters can feature the UpgradeDifficulty flag. Also, BSL scripts can detect the current [[BSL:Game_status|difficulty level]].
* [[XML:BINA/OBJC/TRIG|Laser triggers]] are mostly used to control [[XML:BINA/OBJC/TURR|turrets]]. [[XML:BINA/OBJC/CONS|Consoles]], triggers and [[XML:DOOR|door]] unlocking are used to set up very simple "riddles”.
* The creation of cut scenes is time-consuming quality work. Due to missing tools for streamlined workflows, it is totally okay for you to skip this.
** New synchronized FILM, OBAN and TRAM files are required for cut scenes. Not to mention sound files for dialog.

==The master XML file==
''The project file for level creation.''

The '''master XML''' file's '''name determines''' the '''BSL folder name''' and the '''AKEV and ONLV file names''' in the output folder. File paths in the XML can be either absolute or relative.

'''Mandatory files''' for level import:
* ''level_environment''.dae
* ''level_bnv''.dae
* ''level_textures.tga/jpg/png''
* Character.xml or AISA with player
* ONSK name in <Sky> (in Windows, this can be a fake name; does the Mac need actual ONSK files?)
* ONLD file for the new level; read [[Making_a_mod_package#Mod_Info.cfg|HERE]] about making sure your level is unlocked (accessible on the Load Game screen)

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
|valign="top"| <Level SharedPath="...">
|valign="top"| link
| The master XML file can link to other XML files. Most of them will be [[OBD:BINA/OBJC#OBJC_types|BINACJBO]] files. The file type is declared inside the file, so the file name itself doesn't have to contain the type. Ergo, "BINACJBOCharacter.xml" can be given a simpler name like "Character.xml".

Some resources used by those XML files can be found in a '''shared''' folder. OniSplit copies textures and "physics" objects into the output folder; furniture objects will be integrated into the AKEV. Unused resources in the shared folder will be ignored. That way the final level archive or AE package contains only the necessary files, saving disk space for the end user.

In the demo are various subfolders in the '''shared''' folder: consoles, doors, furniture, triggers and turrets. These file types do not need their file prefixes: CONS, DOOR, TRIG and OFGA. OniSplit will recognize them nonetheless.

'''Common mistake:'''

A few CJBO files '''need relative paths for resources'''. Inserting only a file name will not work. Let us take consoles for example: A relative path to a console should look like this: "'''consoles/console_data.oni'''". The resources are stored in '''shared/console/''' but since the XML master file points to the starting folder via "../shared", it will be omitted in all actual resource paths. If you need, look into the files of the [http://mods.oni2.net/node/299 demo project "lab"]. '''Doors''' and '''furniture''' also require relative paths.

'''lab/lab.xml'''
<?xml version="1.0" encoding="utf-8" ?>
<Oni>
<Level SharedPath="../shared">
...

'''lab/Console.xml'''
<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Objects>
<CONS Id="4695">
<Header>
<Flags>Gunk</Flags>
<Position>944.1944 -27 29.37764</Position>
<Rotation>3.623707E-05 270 0</Rotation>
</Header>
<OSD>
<Class>consoles/console_data.oni</Class>
...
|-
| <Environment>
| -
|
|-
| <Model>
| -
| Used to import level geometry and static objects. See [[#<Model>|HERE]] for detailed information.
|-
| <Import Path="..."/>
| link
|
|-
| <Node Id="...">
| string
| informational (space for notes)
|-
|valign="top"| <ScriptId>
|valign="top"| integer
| Can be used with BSL commands such as ...
: [[#<Model>|env_show ID 1]] (use 0 to hide)
: [[#Breakable glass with BSL recognition|env_broken ID1 [ID2]]] (if a second ID is supplied then objects in the range ID1..ID2 get counted; "3001 3018" would cover 18 objects)
: [[#Texture exchange|env_texswap ID texture]] (no file prefix/suffix allowed)
: [[#env_shade|env_shade ID ID R G B]]
Static objects store their ID in [[XML:AKEV#IDXA_.28quad_group_id.29|one of AKEV's IDXA instances]].
|-
|valign="top"| <GunkFlags>
|valign="top"| flag
|
;AGQG (Gunk) flags (trimmed list)
see ''OniSplit -help enums'' for more flags
:None
:NoCollision
:NoObjectCollision
:NoCharacterCollision
:NoDecal
:TwoSided
:Invisible
|-
|valign="top"| <Rooms>
|valign="top"| -
| For detailed information see [[#<Rooms>|HERE]].

For a Google SketchUp BNV tutorial see [http://oni.bungie.org/forum/viewtopic.php?pid=36760#p36760 HERE].
|-
| <Import Path="..."/>
| link
| File path to *.dae file. BNV data, used to create pathfinding.
|-
| <Textures> {{Anchor|textures_tag}}
| -
| With OniSplit v0.9.94.0+ you can use attributes to set the default import formats and max dimensions. For example:

: <Textures Format="BGR" AlphaFormat="RGBA" MaxSize="512">

Textures with a dimension that isn't a power of two (2x) and textures larger than 512px on a side will be resized. For example, 2003x2000 will become 512x512. (What would 257x255 become?)
|-
| <Texture Name="...">
| string
| TXMP file name to generate.
|-
| <Flags>
| flag
| Optional tag. For list of flags see [[XML:TXMP|HERE]].
|-
|valign="top"| <Format>
|valign="top"| flag
|
:DXT1
:BGR
:RGBA
:BGR555
:BGRA5551
:BGRA4444
|-
|valign="top"| <GunkFlags>
|valign="top"| flag
|
;AGQG (Gunk) flags (trimmed list)
see ''OniSplit -help enums'' for more flags
:None
:NoCollision
:NoObjectCollision
:NoCharacterCollision
:NoDecal
:TwoSided
:Invisible
|-
| <Image>
| link
| File path to *.tga/jpg file.
|-
|valign="top"| <Sky>
|valign="top"| string
| ONSKfile.oni (without file pre- and suffix)

The import doesn't work with an empty tag. <Sky>clear</Sky> helps here; any other fictional name will also do.

For detailed information see [[XML:ONSK|HERE]].
|-
| <Objects>
| -
|
|-
|valign="top"| <Import>
|valign="top"| link
| File path to an OBJC (collection) file. Supported collection files for <Import> are:
: [[XML:BINA/OBJC/CHAR|Character.xml]] (has to contain player character if there's no AISA file with it)
: [[XML:BINA/OBJC/CONS|Console.xml]]
: [[XML:BINA/OBJC/DOOR|Door.xml]]
: [[XML:BINA/OBJC/FLAG|Flag.xml]]
: [[#Furniture.xml|Furniture.xml]]
: [[XML:BINA/OBJC/NEUT|Neutral.xml]]
: [[XML:BINA/OBJC/PART|Particle.xml]]
: [[XML:BINA/OBJC/PATR|PatrolPath.xml]]
: [[#Physics.xml|Physics.xml]]
: [[XML:BINA/OBJC/PWRU|PowerUp.xml]]
: [[XML:SNDD#BINACJBOSound.xml|Sound.xml]]
: [[XML:BINA/OBJC/TRIG|Trigger.xml]]
: [[XML:BINA/OBJC/TRGV|TriggerVolume.xml]]
: [[XML:BINA/OBJC/WEAP|Weapon.xml]]

The following two collection files are '''NOT''' supported. You need to copy them as regular pre-compiled *.oni files into your mod package:
: [[XML:BINA/OBJC/MELE|Melee.xml]] (overrides global MELE; not used in vanilla levels)
: [[XML:BINA/OBJC/CMBT|Combat.xml]] (overrides global CMBT?; not used in vanilla levels)

'''Inside''' the following three supported collection files, provide links to pre-compiled (*.oni) class files: console, door and furniture collections. Use relative paths such as:
:: <code>'''consoles/'''console_data'''.oni'''</code>
:: <code>'''doors/'''TCdouble'''.oni'''</code>
:: <code>'''furniture/'''V_tctf_bigvan'''.oni'''</code>

When you are unsure about the folder structure refer back to the [http://mods.oni2.net/node/299 level import demo].
|-
| <Films>
| -
|
|-
| <Import>
| link
| File path to *.xml file. OniSplit creates a [[XML:FILM|FILM]] file from it. Used for characters in cutscenes.
|-
| <Cameras>
| -
|
|-
| <Camera Path="...">
| link
| File path to *.dae file. OniSplit creates an OBAN file from it. Used for cutscenes.
|-
| <Animation Name="..."/>
| string
| Name for the OBAN file.
|}

This is a trimmed-down version of the master file '''lab.xml''' from the demo. It's meant to give you a first impression. We might upload a smaller demo someday with all features nonetheless.

<?xml version="1.0" encoding="utf-8" ?>
<Oni>
<Level SharedPath="../shared">
<Environment>
<Model>
<Import Path="env/lab_env.dae"/>
<Import Path="env/lab_bomber_window.dae"/>
<Import Path="env/lab_motorcycle.dae">
<Node Id="motorcycle">
<ScriptId>9</ScriptId>
<GunkFlags>NoCollision</GunkFlags>
</Node>
</Import>
</Model>
<Rooms>
<Import Path="env/lab_bnv.dae"/>
</Rooms>
<Textures>
<Texture Name="GOO">
<Format>bgra4444</Format>
<GunkFlags>NoCollision</GunkFlags>
<Image>env/images/GOO.tga</Image>
</Texture>
</Textures>
</Environment>
<Sky>sunset</Sky>
<Objects>
<Import>Character.xml</Import>
<Import>Furniture.xml</Import>
<Import>TriggerVolume.xml</Import>
<Import>Physics.xml</Import>
</Objects>
<Films>
<Import>films/BomberKonRun01.xml</Import>
<Import>films/BomberKonRun02.xml</Import>
</Films>
<Cameras>
<Camera Path="cameras/BomberCam01.dae">
<Animation Name="BomberCam01"/>
</Camera>
<Camera Path="cameras/BomberCam02.dae">
<Animation Name="BomberCam02"/>
</Camera>
</Cameras>
</Level>
</Oni>

===<Model>===
This tag is mandatory (it must be present to avoid errors); the model section contains one import path to the AKEV (level) geometry (*.dae) and can contain additional import paths for exceptions (*.dae).

Data from the demo:

<Import Path="env/lab_env.dae"/>
<Import Path="env/lab_motorcycle.dae">
<Node Id="motorcycle">
<ScriptId>9</ScriptId>
<GunkFlags>NoCollision</GunkFlags>
</Node>
</Import>

'''env_show'''

The motorcycle has here scripting ID 9. You can show and hide the object with the BSL command '''env_show''', where the second parameter means true or false. '''Never use 0 as an ID''' because it won't work.

env_show 9 1
env_show 9 0

EdT demonstrates env_show [https://www.youtube.com/watch?v=Em6wa5JTQNM here]. Note how the objects have collision.

The last vanilla level (Syndicate Mountain Compound) has a big satellite dish platform that can be made hidden. Obviously, such objects/areas can be made to have pathfinding too.

;More possible applications of env_show:
* ground/ceiling/objects for cutscenes that become partially destroyed
* destructible walls like in Deus Ex: Human Revolution (trigger volume, replacing punch anim with punch-through-wall anim)
* grids in front of ventilation shafts (a small door object could be an alternative)
** at the moment this can't be done because characters can't sneak under the top edge of the opening (the characters collision spheres are too big)
* managing object groups with trigger volumes (save multiple objects in one DAE file)



====Import of object groups====
'''Mod Tool versus SketchUp'''

The meaning and behavior of "groups" greatly differs in these two programs.

:'''In SketchUp''' you can group objects which enables you to easily duplicate all objects inside a group and to scale/rotate/translate them all together.

:'''In Mod Tool''' grouped objects are still loose, and duplicating a group won't duplicate the objects. To achieve the same effect as in SketchUp, you have to create a hierarchy where any one object is the "parent" and all others the "children".

'''Google SketchUp'''

To create a group, select two or more objects, right-click on the selection and choose "make group".

[[Image:ModTool_can_import_objs_in_hierarchies.jpg|right|thumb|Mod Tool can import objects in hierarchies to Oni.]]
'''Mod Tool'''

Either use the Explorer (A) or the Schematics (B) to create a hierarchy.

:(A) In the Explorer window, drag and drop one or more objects onto another one.

:(B) Open the constrain tab at the right side. Select parent object, click "Parent", click the child object(s). Check the result in the Schematics window.

:'''Mod Tool: caution when saving to DAE!'''

:A normal selection won't do. You have to select the object tree to successfully save a hierarchy. This is the same way that you do it with Oni characters.


====Breakable glass with BSL recognition====
Broken environmental objects can be recognized by the BSL command ''env_broken (ID_1, ID_N)''. However, this requires additional code to work.

An example is the training level. Let's determine how we can set up such a thing.

First we need a [[XML:BINA/OBJC/TRGV|trigger volume]] like in level 1.

<TRGV Id="11495">
<Header>
<Flags>Locked</Flags>
<Position>-714.6615 -298 -555.2073</Position>
<Rotation>0 0 0</Rotation>
</Header>
<OSD>
<Name>tv75</Name>
<Scripts>
<Entry></Entry>
<Inside>targets_gone</Inside>
<Exit></Exit>
</Scripts>
<Teams>255</Teams>
<Size>400 31 270</Size>
<TriggerVolumeId>75</TriggerVolumeId>
<ParentId>0</ParentId>
<Notes></Notes>
<Flags>PlayerOnly</Flags>
</OSD>
</TRGV>

Now we need some BSL code.

var int inside_target_function;

func void enter_target_function(void)
{
dprint enter_target_function
inside_target_function = 1;
}

func void exit_target_function(void)
{
dprint exit_target_function
inside_target_function = 0;
}

func void targets_are_not_gone(void)
{
# CB: turn off the trigger volume and sleep for a second
# so as not to cause hideous performance loss
trigvolume_enable tv75 0
sleep 60
trigvolume_enable tv75 1
}

func void targets_gone(string ai_name)
{
if (inside_target_function eq 0)
{
enter_target_function() # catch other "targets_gone" functions to let them do nothing

var int num_broken = env_broken(3001, 3018);
# if you only one target use scheme: env_broke(3001, 3001)

if (num_broken eq 18)
{
targets_are_gone();
}

if (num_broken < 18)
{
targets_are_not_gone(); # to set check interval to one second
}

exit_target_function
}
}

func targets_are_gone
{
trigvolume_enable tv75 0
# [...]
}

;Explanation:

Player enters the TV, targets_gone() gets triggered. The variable "inside_target_function" should be 0 by default, so we will enter the "if" block. Next, we can assume that the player didn't destroy all glass objects, so "num_broken" will be less than 18; thus, targets_are_not_gone() gets called.

The TV function targets_gone() ''would'' be triggered every frame, but targets_are_not_gone() creates a delay between checks: the TV gets deactivated for 60 frames. Then the TV becomes enabled again and will start anew until all glass objects got destroyed or player left the TV.

In this case the targets_gone() function will do nothing because "inside_target_function" was set to 1 by the first call.

targets_are_gone() eventually disables the TV to prevent memory overflow; this function also contains all the things ("[...]") that you want to happen after the glass target is broken.

====Texture exchange====
BSL command supported on Windows and Mac:
: env_texswap ID texture

Might be useful to switch on/off static and animated textures. (News broadcast screen: running or off or smashed. Lava stream: flowing or stagnating or cooled down. Etc.)

A similar effect can be achieved by showing/hiding geometries with different textures as EdT has demonstrated in a private test. That way it should also be possible to have different vertex coloring for an area.

====Vertex coloring====
Vertex colors can be edited manually in Blender by setting up following 3 things:
* Properties Panel > Data > Color Attributes
* 3D viewport (left top) > change work mode to Vertex Paint
* 3D viewport (right top) > change to Viewport Shading to Solid mode (under the dropdown menu you can choose "flat" to have full saturation)

{{divhide|Mod Tool}}

[http://web.archive.org/web/20170529111607/http://softimage.wiki.softimage.com/xsidocs/tex_vcolor_CreatingColoratVerticesCAVMaps.htm SoftImage documentation.] Observation: The sniper tower from level 19 Syndicate Mountain Compound can be isolated and re-imported as it is. It will appear quite dark.

If we remove "_color" from the object, the shadows will be gone next time we import the tower.

Mod Tool: Explorer [8]

Object
|
+-- Polygon Mesh
|
+-- Cluster
|
+-- Polygon
| |
| +-- [...]
|
+-- NodeProperties
|
+-- '''_color'''
+-- texcoord (Explicit UVWs)
|
+-- Vertex_Color_Def

So, how do we modify that data?

'''Single object shading'''

If there's already a vertex color property, you can use Shift + W to activate the Paint Vertex Color Tool. With Control + W you can change the brush color. R + Hold Click + Move Mouse let you change the brush size. The more vertices (points) you have, the more detailed you can make the shadows/colors. But keep in mind that too many polygons can destroy collision, making characters fall through the ground.

If there's no vertex color property, the first usage of Shift + W will create that property. But you can also manually create it via Property > Color under Vertices Map.

'''Level-wide shading'''

[[Image:light_test_modtool.png|right|thumb]]
[[Image:light_test_ingame.png|right|thumb]]

To get general shading/lighting you can set up light sources. "Infinite" lights are useful for global lighting, while "Light Box", "Point", "Neon" and "Spot" are more suitable as local light sources. They can be accessed via Primitives > Light.

By default, a Mod Tool scene has one Infinite light, but it doesn't shine in every direction so you might want to add more Infinite lights. Let's say one Infinite light for each direction (+X, -X, +Y, -Y, +Z, -Z) with an intensity of circa 0.25 (night) or 0.75 (day).

The illumination of those lights can be integrated into the vertex color property:
* Property > Color At Vertices Map
* Property > Render Map
* In render map property page, under Sampling select Vertices Only
* Under Surface Color, choose Enable, then in the box below select Vertex _Color; if that option does not appear, click on the New button next to it
* Under Map, select Illumination only
* Finally, click on the button Regenerate Maps...

This must be done for all objects separately.

: [http://mods.oni2.net/system/files/vertex_color_script.txt There's a script here] which can apply vertex color and render maps to all '''selected''' objects. Load it into the script editor with Alt + 4 and hit F5 to run it. (Be sure the script's language was set to VBScript.)
: The variable "overwrite_VC" can be changed.
:: With "1" all existing CAV maps of selected objects will be overwritten. This can take some time.
:: With "0" only selected objects without CAV maps will be the script's target.

'''Notes on ModTool view modes'''
* "Constant" let you see the colors of the vertex coloring only.
* "Textured Decal" let you see object textures only.
* "Shaded" let you see the illumination only.
* "Textured" let you see the textured object with illumination and vertex coloring.
{{divhide|end}}

=====env_shade=====
If you use '''env_shade''', use it with caution. It completely overwrites the vertex coloring.

# BSL command
# env_shade obj_id obj_id R G B

# examples
env_shade 7 7 # object 7 will be black
env_shade 7 7 0 0 0 # object 7 will be black
env_shade 7 7 .31 .999 .5 # object 7 will be quite green
env_shade 7 10 1 1 1 # object 7, 8, 9, 10 lose all their shading

====Baked lightmaps====
A drawback of this method, AKA shadow maps, is the high number of [[XML:BINA/TMBD|TMBD]] changes and new textures for every wall, requiring a lot of memory. How to create shadow maps:

* https://web.archive.org/web/20121105081823/http://www.game-artist.net/forums/support-tech-discussion/5622-burning-shadows-onto-texture-xsi.html


Notes on map options:
* "Surface color and illumination": outputs used texture with added shadows
** Can be used to replace original texture
* "Illumination only": output a texture that only contains the shadows
** Can be used on a new overlying, transparent surface

====Standalone lightmaps====
With this approach there are two meshes, whereby the shadow effects on one mesh get drawn in front of the regular level texture.

Compared to the "baked lightmaps" method, this needs more polygons of course. And these polygons are transparent, which is a problem with Oni's limited rendering ability for such textures. However, standalone lightmaps only need a few new textures if used wisely.

Read [[Lightmapping levels]] to learn more.

[[Image:Oni_Lightmaps_double_polygon_method.jpg|center]]

===<Rooms>===
The Rooms tag is mandatory. It contains an import path to BNV and ghosts (*.dae) which are used to create pathfinding grids. For information on the binary data behind this, see [[OBD:AKVA|HERE]].

Sample code from the master XML file:
<Import Path="env/lab_bnv.dae"/>

'''Fundamentals'''
* '''BNVs''' are '''volumes''' (sometimes also named '''rooms''') that have a pathfinding grid assigned to them.
* For practical reasons you only need '''floors and ramps''' to build a BNV. (As seen [http://edt.oni2.net/images/Hideout_BNV.jpg HERE.])
** A BNV polygon can consist of 3 or more points, but it's recommended to use '''shapes with 4 points''' because the other shapes usually waste more grid space. At the moment you can import only '''[[wikt:convex|convex]]''' shapes.
* Secondly, there are so called '''ghosts''' (vertical quads) that connect '''neighboring BNVs'''. AI can only transit from BNV to another through ghosts.
: OniSplit gives error messages for ghosts that don't have 2 neighboring BNVs, for example:
BNV Builder: Ghost 'grid2' has no adjacencies at <-72,41 1,999 -166,6> and <-71 1,999 -168,21>, ignoring

'''Tolerance values'''
* Horizontal distance from room to ghost: 1
* Vertical distance from room to ghost: 18
* Ghost's horizontal dimension must be greater than 0
* Under optimal circumstances, pathfinding works on a plane that is +4 world units above or -0.5 below the pathfinding grid
* Normally characters can't pass over low vertical walls such as stairs/curbs if those don't have a ramp under them; near ground level (Y=0) is an exception where characters are allowed to step on a plane that is 4 world units above pathfinding grid; higher planes need a ramp
* Maximum angle of ramp you can go on is 70°; higher angles will make characters fall through to their death (in those cases you might want to add invisible walls/boxes to prevent them from touching the ramp)

'''More notes on PF processing'''
* Actually, BNV and ghosts can have any name and don't need any texture.
* During pathfinding calculation, OniSplit creates a new folder called "temp" and a subfolder "grids". There is a file named "''levelname''_grids.dae". That file contains rooms with textures called "bnv_grid_''N''.tga" which mark obstacles in the pathfinding grid. Ghosts will have a transparent texture "'''_marker_ghost'''.tga". You also get these when you export a level. Transparent ghosts make it easier to see the rest of your level if you have many of those planes.
* In Mod Tool, ghosts and rooms can be grouped under a null object. Right-click the null object to select all its children, then use "Selection Only [x]" as your saving option. That way all the planes can be quickly saved to a *.dae file.
* You can influence the pathfinding creation of dangerous zones using danger quads. Read about those [[#Marker textures|HERE]].
* Another kind of influence is the [[#<Model>|gunk flag]] IgnoreGrid. It can be used to tell OniSplit to ignore the object during pathfinding creation. The grids in that place will be white.

[[Image:Pathfinding_grid.jpg|thumb|200px|right|'''ai2_showgrids = 1''' in action]]
'''BSL commands'''
* chr_show_bnv = 1
:: shows number of BNVs the player is standing on
* ai2_showgrids = 1
:: shows pathfinding grids
* ai2_chump
:: spawns a friendly Striker that follows the player if possible, makes also pathfinding grids visible
* ai2_chump_stop = 1
:: Striker stops following you
* ai2_chump_stop = 0
:: Striker follows you again

====Pathfinding on uneven ground====
Pathfinding works on slightly uneven ground as long as the polygons are 0.5 world units beneath or 4 world units above the BNV.

For greater surface irregularities, we can use a trick:
* The problematic polygons must be saved to a DAE file and then referenced in the model section as an individual object.
* Then the <GunkFlags> tag needs to be '''''GridIgnore'''''.
* Additionally we create a plane (invisible if necessary) under the object so that Oni doesn't think there's a hole.
* The ghosts must be taller than the highest polygon to be walked on. (This has been tested up to a height of 2,000 world units.)

'''Symptoms of too-small ghosts'''

A) AI can't run at all.

B) AI loses PF ability if the tracked enemy performs animations that are outside of the pathfinding volume. Here's a video (<nowiki>https://youtu.be/vfKPzP5hiCo</nowiki>, dead link) showing these symptoms.

'''Missing boundaries'''

Let's say you have a BNV, tall ghosts, and a GridIgnore-flagged hill with trees and bushes and stuff.

Why do AIs run up against the trees?
: '''Problem:''' There are no red/orange grids that limit the AI's movement. Normally, objects will produce red pathfinding squares around them. But objects that are 20 world units above the BNV are ignored just like objects with the IgnoreGrid flag.
: '''Solution:''' Add simple geometries like ''_marker_impassable fences'' or danger quads near the BNV.

'''Disappearing AIs'''

The ground is sometimes not solid, and the player and AIs are falling through it.

: '''Problem:''' On GridIgnore-flagged uneven ground, AIs can fall through it when they are out of the player's view.
: '''Solution:''' Use either '''chr_lock_active ''AI_name''''' or '''chr_all_active = 1'''

====Debugging====
'''(OniSplit v0.9.93.0+)'''
[[Image:OniBrowser.jpg|thumb|200px|right|OniBrowser displaying level geometry plus PF and ghosts.]]

* '''env_show_ghostgqs = 1''' makes the ghost quads visible
** The original ghost quads can't be seen; per Neo, "they are not included in the octtree and bsp tree"
** To see them you must use the -debug option in the level creation command (available with OniSplit '''v0.9.93.0+''')
OniSplit.exe -create:level ''output_folder'' '''-debug''' ''input_folder''/''master_xml_file''.xml

Not all debugging/testing needs to be done in Oni. There is also a [http://mods.oni2.net/node/256 program] (Windows only) which can display the whole level.

For example you can load an AKEV*.oni, select the level name, and use the hotkeys [B] and [P] to display BNVs and ghosts.

'''Bug prevention:'''

After all testing is done, you should compile the level a last time without the -debug option.

AIs appear to have trouble shooting through ghost quads that got registered in the octtree/BSP tree as seen here (<nowiki>https://www.youtube.com/watch?v=-ZugVBgBVKc</nowiki>, dead link).

====When OniSplit fails to connect PF quads====
[[Image:Pathfinding_creation__merge_polygons_to_fix_connections.jpg|thumb|200px|right|Fixed PF in compound level after underground construction...]]
It can help to merge polygons to one object and merge their edges. These become white. (Outer edges are blue.)

===<Textures>===
====...used for exceptions====
The [[#textures_tag|textures tag]] is mandatory.

AKEV textures will be imported by the master XML file automatically; you don't need to add them to that file.

: With OniSplit v0.9.82-93.0, the textures' formats will be DXT1 and (for transparent ones) BGRA4444.
: With OniSplit v0.9.94.0+ the textures' formats will be BGR and (for transparent ones) RGBA.

To change the default texture import format, use the Texture'''s''' tag. (Possible with OniSplit v0.9.94.0+.)

To change the format/flag/gunk flag of a specific texture, use the Texture tag.

An example:

<Textures Format="BGR" AlphaFormat="RGBA" MaxSize="512">
<Texture Name="GOO">
<Flags>TwoSided</Flags>
<Format>BGRA4444</Format>
<GunkFlags>NoCollision</GunkFlags>
<Image>env/images/GOO.tga</Image>
</Texture>
</Textures>

* Use the gunk flag "TwoSided" to make surfaces visible from both sides.
* If the texture comes with the gunk flag "NoCollision" then all objects with that texture will have no collision. Characters would fall through it.

Transparency and no collision together would make sense for a water-like substance. The Vago Biotech level uses this approach for the area with green toxic waste.

[[Image:making_a_surface_transparent_and_twosided.png|thumb|200px|right|'''Figure 1''']]

[[Image:AKEV_single_object_multiple_textures.png|thumb|200px|right|'''Figure 2''' one object with multiple textures, one per polygon cluster]]
[[Image:AKEV_single_object_multiple_textures_ingame.png|thumb|200px|right|'''Figure 3''' blue: two-sided glass: two-sided and transparent random metal: no flag (one-sided)]]

'''TwoSided and transparent objects'''

It's also possible to set this in Mod Tool. For TwoSided-ness, use one image source for diffuse and transparency. (It won't work with two image sources even if both sources use the same image.)

For transparency you must additionally use the three checkboxes:
* Transparency: Enable
* Transparency: Use Alpha
* Transparency: Invert

See '''Figure 1'''.

====Regular textures====
OniSplit automatically imports textures of objects in the [[#<Model>|<Model> section]]. Those objects could be considered as AKEV core geometry.

'''One texture per object'''

Furniture and Physics objects are allowed to have only one texture per object. AKEV core geometry can have one texture or multiple textures – that's up to you to decide.

'''Multiple textures per object'''

'''Question:''' How do we apply multiple textures to an AKEV core object?

'''Answer:''' Assuming you are using Mod Tool the procedure will be as follows. Repeat this for each cluster you create (except for projection). See also '''Figure 2 and 3'''.

* Select some polygons
* Go to Material > Phong
* Hit [7] to open Render Tree
* Add a texture and connect "Image" with "Phong", choose "diffuse" as illumination mode
* Double-click "Image" to open Material page
* In the Texture Projection section, click on "New" and choose a suitable projection
** Do this only if there isn't a projection in the "Texture_Coordinates_AUTO" cluster yet
** OniSplit processes only one texture projection, see '''Figure 4'''
* Choose the texture and UV, then fine-tune the UV via Alt + 7

[[Image:AKEV_multiple_textures_one_projection.png|thumb|200px|right|'''Figure 4''' use only one texture projection per object]]

Caution: textures will be fixed to one set of flags. You can't use the same texture A for a one-sided cluster/object B and a two-sided cluster/object C. You would need to create a differently-named clone of that texture and apply that to cluster/object C.

====Marker textures====
Marker textures are used to import certain objects with special flags. Import those objects alongside [[#<Model>|AKEV core]] geometry.

Marker textures aren't imported automatically. Add those textures to the final package or plugin yourself, e.g. with some sort of script.

OniSplit.exe -create:txmp out env/markers/*.tga

The flags Transparent, TwoSided and NoOcclusion are only set if the same texture source is used for diffuse and transparency and if transparency setting are enabled. See the subsection under "[[#...used for exceptions|...used for exceptions]]" called "TwoSided and transparent objects".

'''Danger quads'''

Pathfinding grids have different colored squares with different meanings.
* white/gray - clear space
* green light - near wall
* green - semi-passable
* green dark - stairs
* blue very light - border 1
* blue light - border 2
* blue - border 3
* blue dark - border 4
* '''orange - danger'''
* red - impassable

For detailed information on colors, see [[OBD_talk:AKVA/0x24#EFFECTS_of_various_pathfinding_grid_tile_types|HERE]].

Normally, OniSplit decide how to color the grids. But it's possible to add your own danger quads to fine-tune zones of higher danger. Those orange areas will be generated with the 4 different blue borders around it.

Danger quads must have "'''_marker_danger'''" as texture name.

Results in flags: Transparent TwoSided NoCollision Invisible NoOcclusion Danger

'''_marker_barrier'''


Results in flags: Transparent TwoSided(double-check) Invisible NoObjectCollision NoOcclusion

'''COLLISION (boxes)'''

AIs can get stuck in detailed geometry. This can be prevented with collision boxes. In-game the box will be invisible, but has collision so characters can't get through. The pathfinding grid will be red where it comes in contact with the box; the red is followed by a light green and then regular green.

[[XML:OFGA|OFGAs]] use the COLLISION texture. Onisplit doesn't automatically apply gunk flags to it. You need to use XML tags for that. Typically it would be <GunkFlags>Invisible NoObjectCollision</GunkFlags>

'''Stairs'''

Texture: '''_marker_stairs'''

Normally, characters can't move on stairs because they contain vertical rises. In this case you can use a sloping quad that is above or inside the staircases. It's possible to set the desired flags in the <Model> section, but doing so and exporting these self-made stair ramps is wasted time. Simply apply _marker_stairs to that quad and characters will be able to move on that surface.

Resulting flags: Stairs Transparent TwoSided Invisible NoObjectCollision NoOcclusion

This has no effect on pathfinding creation. Regularly-textured stair geometry (which intersects the marker quad) will be flagged as NoCharacterCollision.

'''Impassable'''

texture: '''_marker_impassable'''

Resulting flags: Transparent TwoSided (<-double-check this) Invisible NoOcclusion

Impassable walls are very similar to collision boxes except that particles can also collide with them. The pathfinding grids will be also red, light green, and green.

'''Blackness a.k.a. jello fix'''

Texture: '''_marker_blackness'''

Resulting flags: TwoSided NoCollision

Simply black walls. No effect on pathfinding creation. The purpose of these walls in Oni is to block out areas outside of a level's outermost wall so that the Jello-cam cannot show the player other parts of the level when it escapes a wall. See [[Jello-cam]] for details.

'''Doors'''

Texture: '''_marker_door'''

Resulting flags: DoorFrame Transparent TwoSided NoCollision NoOcclusion

Don't use this.

===<Objects>===
Information on regular object lists can be looked up here:
: [[XML:BINA/OBJC/CHAR|Character.xml]] (has to contain player character if there's no AISA file with it)
: [[XML:BINA/OBJC/CONS|Console.xml]]
: [[XML:BINA/OBJC/DOOR|Door.xml]]
: [[XML:BINA/OBJC/FLAG|Flag.xml]]
: [[XML:BINA/OBJC/NEUT|Neutral.xml]]
: [[XML:BINA/OBJC/PART|Particle.xml]]
: [[XML:BINA/OBJC/PATR|PatrolPath.xml]]
: [[XML:BINA/OBJC/PWRU|PowerUp.xml]]
: [[XML:SNDD#BINACJBOSound.xml|Sound.xml]]
: [[XML:BINA/OBJC/TRIG|Trigger.xml]]
: [[XML:BINA/OBJC/TRGV|TriggerVolume.xml]]
: [[XML:BINA/OBJC/WEAP|Weapon.xml]]

====Furniture.xml====
The AKEV core geometry is more or less the overall structure of the level while this furniture file adds standard objects (e.g. crates and desks) to it.

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Objects>
| -
| This tag marks the file as BINACJBO.
|-
| <Furniture>
| -
| This tag marks the file as FURN.
|-
| <Header>
|
|
|-
|valign="top"| <Flags>
|valign="top"| flag
| Optional tag. Ignore it. Those flags were used in the past.
:None
:Locked
:PlacedInGame
:Temporary
:Gunk
|-
| <Position>
| float x3
| Optional tag. X Y Z position.
|-
| <Rotation>
| float x3
| Optional tag. X Y Z rotation.
|-
| <OSD>
| -
|
|-
|valign="top"| <Class>
|valign="top"| link
| File path to a '''pre-compiled [[XML:OFGA|OFGA]] (*.oni) file'''. Use it as part of a relative path. Make sure that the OFGA comes with the files it needs: M3GM and TXMP.

An OFGA can hold multiple M3GMs. That 3D content will then be integrated into the AKEV.
|-
|valign="top"| <Particle>
|valign="top"| string
| This name gets written into <Tag> inside ONLV (ENVP section) and can be used with BSL commands, e.g. you can take control over a particle via '''particle BSL_name start'''. For more commands, see [[XML:BINA/OBJC/PART#BSL_support|HERE]].

Take care with the naming of new OFGA files. The particle name will be composed of 2 parts separated by an "_" underscore. When one tag is empty, the final name will contain an underscore nonetheless. '''Examples:'''

: FURN <Particle>test</Particle> + OFGA <Tag>streetlight</Tag> = '''test_streetlight'''
: FURN <Particle></Particle> + OFGA <Tag>streetlight</Tag> = '''_streetlight'''
: FURN <Particle>test</Particle> + OFGA <Tag></Tag> = '''test_'''
|}

;Example

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Objects>
[...]
<Furniture>
<Header>
<Flags>Gunk</Flags>
<Position>-62.692 -29 108.35</Position>
<Rotation>181.522 356.021 178.114</Rotation>
</Header>
<OSD>
<Class>furniture/V_tctf_bigvan.oni</Class>
<Particle></Particle>
</OSD>
</Furniture>
[...]
</Objects>
</Oni>

====Physics.xml====
This file is for objects with "physics". Unlike AKEV core geometry or furniture, these objects can be animated.

: A small video tutorial on [https://www.youtube.com/watch?v=CFNseg_2UxA how to create a simple animated object]

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Physics>
| -
|
|-
| <Object Name="...">
| string
| Use a unique name for each object.
|-
|valign="top"| <ScriptId>
|valign="top"| integer
| Tested with BSL command...
:obj_create ID [ID]
:obj_kill ID [ID]
:env_anim ID [ID]
:env_setanim ID [ID]
The scripting ID will be stored in the ONLV's OBOA instance.
|-
|valign="top"| <Flags>
|valign="top"| flag
|
;Object setup flags
:None
:InUse
:NoCollision
:NoGravity
:FaceCollision
|-
|valign="top"| <Physics>
|valign="top"| flag
| Optional tag for an Object.
:None
:Static
:Linear
:Animated
:Newton (used with <Flags> FaceCollision to [https://www.youtube.com/watch?v=YICB7qugrtc make an object pushable])
:: For a pushable object don't use import sub-tags such as animation name, flags, etc. Just use <Import Path="..." '''/'''> or <Import Url="..." '''/'''>
|-
| <Position>
| float x3
| Optional tag of Object. Only used for non-animated objects. X Y Z position.
|-
| <Rotation>
| float x3
| Optional tag of Object. Only used for non-animated objects. X Y Z rotation.
|-
| <Scale>
| float
| Optional tag of Object. Only used for non-animated objects.
|-
|
<Import Path="...">

<Import Url="...">
|valign="top"| link
|valign="top"| This tag comes in two variants. It doesn't matter what variant you use.
|-
| <Animation Name="...">
| link
| File path to *.dae file.
|-
|valign="top"| <Flags>
|valign="top"| flag
| Optional tag of Animation. For more information on those flags look [[XML:OBAN|OBAN]] page.

;Object animation flags
:None
:Loop
:PingPong
:RandomStart
:AutoStart
:Local
|-
| <End>
| integer
| Optional tag of Animation. Frame number. Used to define the end of an OBAN from a *.dae file.
|-
| <Start>
| integer
| Optional tag of Animation. Frame number. Used to define the start of an OBAN from a *.dae file.
|}

The XML code for physics can be written in two styles.
*The '''first style''' mimics the original structure found in extracted ONLV instances. This makes it '''easier to edit old levels and reimport them''' into the game.
*The '''second style''' was created with structured data (nested objects) in mind and is '''suited for totally new levels''' where animated objects must be created in a 3D editor at first.

'''Code style 1'''

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Physics>
<Object>
<Geometry>M3GMDishBase.oni</Geometry>
<Animation>OBANDishBase.oni</Animation>
<Physics>Animated</Physics>
<ScriptId>201</ScriptId>
<Position>-197.729141 128.46283 -2501.46387</Position>
<Rotation>0.7071067 -1.545431E-08 1.545431E-08 0.7071068</Rotation>
<Scale>2.109375</Scale>
<Name>object_DishBase</Name>
</Object>
</Physics>
</Oni>

'''Code style 2'''
:For documentation purposes, the file here has been trimmed down.

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Physics>
[...]
<Object Name="motorcycle">
<ScriptId>8</ScriptId>
<Flags>FaceCollision</Flags>
<Import Url="motorcycle/export.dae">
<Animation Name="motorcycle02">
<Flags>AutoStart</Flags>
<End>880</End>
</Animation>
<Animation Name="motorcycle02_stop">
<Start>881</Start>
</Animation>
</Import>
</Object>
[...]
</Physics>
</Oni>

In this example, OniSplit takes the file "export.dae", looks at the parts it contains, and creates geometry files from it.
* M3GMhubs_rear.oni
* M3GMhubs.oni
* M3GMmotorcycle.oni
It's convenient that hierarchies are supported here.

The motorcycle is made of 3 parts so 3 object animations ([[XML:OBAN|OBAN]]) will be created up to frame 880. Then OniSplit creates 3 more OBANs starting from frame 881.

The reason for the interruption at frame 880 is probably to give Barabas a little more camera time in the cutscene.

;Notes about BSL usage:

The Vago Lab cutscene script uses the motorcycle objects and animations like this:
env_show 8 0 # hide static motorcycle parts or else they would be visible
env_show 9 0 # while Konoko is still riding her animated motorcycle
env_show 10 0 # the static motorcycle is separated into objects 8, 9 and 10

# Static and animated objects are totally independent from each other.
# They are stored in different arrays so their script IDs can use the same numbers.

obj_create 8 10 # create all animation-ready motorcycle parts
env_anim 8 10 # animate those parts (not necessary if OBAN flag is "AutoStart")

# The first animations would loop because of "AutoStart", so get the
# right timing to apply the other animations. "motorcycle02_stop"
# and the others will not loop because they don't have "AutoStart".
env_setanim 8 hubs_stop
env_setanim 9 hubs_rear_stop
env_setanim 10 motorcycle02_stop

obj_kill 8 10 # delete all animated parts
env_show 9 1 # show static motorcycle model where Konoko parks her bike

====Corpses.xml====
An empty Corpse element (<Corpse />) is treated as unused and placed at the end of the array. If no such empty elements are provided, OniSplit automatically adds 5. OniSplit also ensures that there are at least 20 corpses in the array.

{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Corpses>
|
|
|-
|valign="top"| <Corpse>
|valign="top"| -
|
|-
| <Class>
| link
| [[XML:ONCC|ONCC]]''name''
|-
| <Transforms>
| -
| There are 19 <Matrix> for each <Transforms> (which represents a body part).
|-
| <Matrix>
| matrix
| Float 3x3 + float x3 for the last 3 values (X Y Z position). For more information about the matrix, see [[OBD:CRSA]].
|-
| <BoundingBox>
| -
| Bounding box of the whole corpse. Optional; if not provided, OniSplit will generate an approximate one. Currently it doesn't try to locate the ONCC to compute an exact bounding box.
|-
| <Min>
| float x3
|
|-
| <Max>
| float x3
|
|}

'''Trimmed example'''

<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Corpses>
<Corpse>
<Class>generic_male_1</Class>
<Transforms>
<Matrix>-0.36488995 0.04620622 -0.9299034 -0.05580434 -0.9980576 -0.02769538 -0.9293768 0.04178688 0.366759717 -215.667755 1.603917 92.85312</Matrix>
<Matrix>0.2961557 -0.185628444 0.936928 -0.368288517 -0.9272724 -0.06730227 0.8812806 -0.32512787 -0.342981815 -216.51889 1.64218426 93.189</Matrix>
<Matrix>0.407847315 0.156575248 0.8995248 -0.238757968 -0.9326179 0.2705892 0.8812805 -0.3251278 -0.342982143 -215.239883 0.8405094 97.23532</Matrix>
<Matrix>0.439697325 0.467113584 0.767118752 0.0248355754 -0.8601105 0.5095029 0.8978026 -0.204975232 -0.389789373 -213.6234 1.46109009 100.80056</Matrix>
<Matrix>0.717241049 -0.179043233 0.673430443 0.4761817 -0.579636 -0.6612664 0.5087397 0.794962764 -0.3304816 -214.81662 1.56564879 92.5172348</Matrix>
<Matrix>0.3398023 0.1672905 0.925498843 0.7910236 -0.5831365 -0.185023025 0.5087395 0.7949628 -0.330481827 -211.71907 0.792413354 95.42558</Matrix>
<Matrix>0.1283634 0.227430075 0.965297 0.804142356 -0.59352535 0.032904774 0.5804117 0.7720126 -0.259073079 -210.372269 1.45546341 99.0937653</Matrix>
<Matrix>-0.285799921 0.06851995 -0.955836535 -0.240357026 -0.970681965 0.00228381017 -0.927656651 0.230394751 0.2938901 -216.284851 1.5839076 91.29168</Matrix>
<Matrix>-0.312039882 0.04875436 -0.948817253 -0.176752359 -0.9842264 0.00755515043 -0.9334825 0.1700632 0.31573534 -216.689789 1.68287766 89.9359055</Matrix>
<Matrix>-0.356412441 -0.5390179 -0.763170958 0.0404523835 -0.82494843 0.5637587 -0.933452547 0.170058519 0.315826446 -217.422012 1.7979821 87.70907</Matrix>
<Matrix>-0.101782769 -0.247171819 -0.9636112 0.5426916 -0.8256094 0.154451028 -0.8337422 -0.507223248 0.2181709 -217.747284 1.30605173 87.0125656</Matrix>
<Matrix>-0.8154478 -0.150626346 0.558888733 -0.1200991 0.9885643 0.09119747 -0.566234052 0.00724477554 -0.8242127 -217.7402 2.065678 88.15346</Matrix>
<Matrix>-0.4593738 -0.326781839 0.825947642 0.8874048 -0.1284554 0.442732215 -0.0385793857 0.9363295 0.348996729 -219.093979 1.81561315 89.08131</Matrix>
<Matrix>-0.9545983 -0.13777709 0.26412034 0.295387268 -0.322961926 0.899134 -0.0385792255 0.9363296 0.348996431 -220.3681 0.9092429 91.37218</Matrix>
<Matrix>-0.9715769 -0.0362956524 0.233924776 0.0276728421 -0.9988148 -0.0400396362 0.2351007 -0.0324283168 0.9714299 -222.775482 0.56178683 92.03825</Matrix>
<Matrix>0.979860842 -0.192433611 0.0533096045 0.193336874 0.9810555 -0.0122905634 -0.0499345176 0.0223497637 0.9985025 -216.8387 1.90143847 87.84845</Matrix>
<Matrix>0.863898 -0.399280578 0.3070101 0.171117 -0.340619326 -0.9244986 0.4737078 0.851207137 -0.225936681 -215.211975 1.58196676 87.93695</Matrix>
<Matrix>0.4673251 -0.0255063027 0.883717656 0.746463835 -0.524209559 -0.4098731 0.4737075 0.851207256 -0.225936785 -212.815842 0.47451216 88.78848</Matrix>
<Matrix>0.216871262 -0.007893051 0.976168454 0.3751846 0.9238389 -0.0758833 -0.9012231 0.3827002 0.203315422 -211.637314 0.410188764 91.0171051</Matrix>
</Transforms>
<BoundingBox>
<Min>-219.731216 -2.258905 84.47974</Min>
<Max>-207.518463 4.49535131 104.023239</Max>
</BoundingBox>
</Corpse>
</Corpses>
</Oni>





[[Category:Modding tutorials]]

BGI characters

2025-12-26T06:16:46Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

This is a series of new characters intended for use in adding the entity [[BGI]] to the game, developed by [[User:Samer|Samer]]. They include either completely new concepts or concepts based on the ideas discussed in [[AE:BGI]]. They all share a common color scheme of white, black, and different shades of green/teal. All the playable characters have customized movesets and green contrails and hit impacts.

==BGI Executives==
*First concept by [[User:Geyser|geyser]] is found [[AE:BGI#Executives|here]].
*In Samer's version these are non-fighting characters, wearing suits and rarely seen in the field, if ever.
*They run BGI, working behind the scenes on grand scales.
[[Image:BGI Executives 1.jpg]]
[[Image:BGI Executives 2.jpg]]

==Sarai==
*[[Sarai]] is a female BGI boss working directly under the Executives' orders.
*More information on the character can be found by clicking on her name.
*Mod available [http://oni.bungie.org/forum/viewtopic.php?pid=46869#p46869 here].
[[Image:Sarai.jpg|640px]]

==BGI Agents==
*These were previously considered the Executives, however in Samer's version these are called the BGI Agents and they are field agents, the equivalent of the Syndicate [[Comm Trooper]].
*These guys usually accompany [[Sarai]] as her henchmen; they are strong and quick in addition to being highly technologically skilled and experts in weapons.
*Mod available [http://web.archive.org/web/20160225030429/http://oni.bungie.org/forum/viewtopic.php?id=1329 here].
*The mod includes 2 classes, "Lite" and "Blackops", Blackops being an upgraded difficulty class. Each class has 3 variants. (6 variants total)
[[Image:Bgi agents lite.jpg]]
[[Image:Bgi agents blackops.jpg]]

==BGI Hammer==
*This giant cyborg has shock generators at the end of his arms, making contact with his punch almost lethal. His techniques include shockwaves and electrical attacks.
*The character concept was first mentioned by Leus [http://oni.bungie.org/forum/viewtopic.php?pid=19624#p19624 here].
*:(A major influence of the concept was [[wp:Rhino_(character)|Marvel's Rhino]] as seen [http://web.archive.org/web/20210324174207/https://www.renderhub.com/rip-van-winkle/rhino-from-marvel-strike-force here])
*The model and textures are made by [[User:Ltemplar|Ltemplar]].
*Mod available [http://oni.bungie.org/forum/viewtopic.php?id=2490 here].
[[Image:BGI Hammer.jpg]]

==BGI Hydra==
*This female SLD is based on Sarai and would share some of her moveset. Her legs have been mechanically and technologically enhanced giving her the ability to jump high and deliver high damage with kick attacks. Her moveset would include all kick moves, and throws utilizing her legs, with no punches. She would be very fast and agile, but would have low health. She would be considered relatively common, similar to how common furies and tankers are to the Syndicate.
*The character concept was first mentioned by Leus [http://oni.bungie.org/forum/viewtopic.php?pid=19624#p19624 here].
*The design of the character took inspiration from [[Hikari]].
*Mod discussion [http://web.archive.org/web/20160224173752/http://oni.bungie.org/forum/viewtopic.php?id=2936 here].
[[Image:BGI Hydras.jpg]]

==BGI NinjaBot==
*A light and quick BGI Bot.
*Model imported by Samer, original model found [https://downloadfree3d.com/3d-models/weapons/robot/robot-warrior/ HERE] and [http://web.archive.org/web/20210122041553/https://www.domawe.net/2014/09/robot-knight-3d-model-free-download-rf.html HERE].
*:(Later identified as an Accretian Warrior from the MMORPG [https://www.gameogre.com/reviewdirectory/reviews/RF_Online.php RF Online].)
*He has a custom TRAC (mix of Ninja's and Training Droid's (Comguy) moves).
*Mod available [http://web.archive.org/web/20170517033156/http://oni.bungie.org/forum/viewtopic.php?id=2438 here].
[[Image:BGI NinjaBot.jpg]]

==BGI Heavy Bot==
*The general idea of a "BGI heavy" is by geyser, discussed [[AE:BGI#Candidate|here]].
*Model imported by geyser (from an unsourced SketchUp model)
*:(Years later, it was identified as [https://models.spriters-resource.com/pc_computer/unrealtournament2004/asset/286716/ Widowmaker] from UT2004)
*Textures and UV map correction were done by Ltemplar.
*Custom TRAC and slight texture modifications by Samer.
*This character was originally referred to as BGI Trooper but this was changed to BGI Heavy Bot, making the BGI Trooper an armored form of BGI Agent.
*Mod available [http://web.archive.org/web/20160224193743/http://oni.bungie.org/forum/viewtopic.php?id=2445 here].
[[Image:BGI Heavy Bot.jpg]]

[[Category:BGI]][[Category:Modding projects]]

Anniversary Edition/Installer

2025-12-26T06:16:32Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

AE Installer 2 (AEI2) is the program used to install mods, patches and tools, as part of the [[Anniversary Edition]]. The app requires Java, as well as .NET 2.0 or higher in Windows and Mono in macOS. The AEI2 has a support thread on the forum [http://web.archive.org/web/20200224104659/http://oni.bungie.org/forum/viewtopic.php?id=2525 here]. The source code is available [https://websvn.illy.bz/browse/Oni2/java/ here].

The AEI talks to the {{OMD}} and gets a list of available mods (the list is cached, but updated every two minutes). It then offers those for download and installation. It will also detect when an installed mod has an update available, and can even update itself using the supporting program [[/Updater|AEInstaller2Updater]]. The AEI also supports localization (easy translation into other languages). Currently the AEI can run in English, German, and Russian; if you want to contribute a new localization, read [[/Localization|this page]]. You can email Alloc with your strings when you're done.

:''Subpages:'' [[/Change log|Installer change log]], [[/Localization|Localization]], [[/Updater|Updater]]

==GUI scaling==
On modern displays you may want to change the DPI settings of the program, otherwise text, tables and controls will appear too small.

'''Windows:'''
: Right-click the shortcut "AEInstaller2", choose Properties and go to the Compatibility tab
: (Windows 8) Check the "Disable display scaling on high DPI settings" box
: (Windows 10, 11) Click the "Change high DPI settings" button: [x] Override high DPI scaling behavior: System (Enhanced)

==Main window==
[[Image:AEI main window.jpg|center]]

*Status column - Each mod starts off with "___", three blank spots. The first will become 'I' when the mod is "installed", the middle space will become 'U' if an "update" is available, and the last becomes 'D' when you've "downloaded" the mod.

*As long as the mod list is the active window pane, you can press any letter to jump to the mod that begins with that letter; press it again to cycle through the remaining mods that start with that letter.

*You can sort the mods by clicking on the column headers; sort by the "Last change" or "Added" columns to see what's new on the Depot.

*The AEI will remember the sort order you choose, what columns you choose to display, and the window size you set it to have.

*You can hide/show columns by right-clicking the column header:
[[Image:AEI column menu.jpg|center]]

*You can right-click a mod to go to the mod's page on the Depot, go to the package on your HD (if downloaded), delete the mod locally (if downloaded), or force a re-download; this might be useful if you messed up or deleted the content of the mod on your hard drive, or if you think you got a corrupted download.
[[Image:AEI mod context menu.jpg|center]]

==Mods menu==
*You can save a list of your current selection of mods by choosing '''Mods>Save current mod selection''', then restore the list later using '''Mods>Load mod selection''' (this only saves the list of selected mods, not the actual mods).

==Settings==
*Also, don't forget to check out the AEI's Settings. Notice that the AEI copies over [[outro]] by default, but not [[intro]]. It's recommended that you keep the update notification option checked.
[[Image:AEI settings.jpg|center]]

==Core packages==
*You can view core packages by choosing '''Mods>Show core packages'''. You can view the description of these packages, and right-click to open their mod folder, or to re-download them if necessary, but you can't delete them. These packages will always be automatically installed and updated.
[[Image:AEI core window.jpg|center]]

==Tools==
*You can manage modding tools by choosing '''Tools>Manage Tools'''. From there you can download and install or uninstall tools. Installed tools will later appear under the '''Tools''' menu for easy access.
[[Image:AEI tool window.jpg|center]]

[[Category:Anniversary Edition]]

History of Oni modding

2025-12-26T06:16:23Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{Hatnote|This article is a historical perspective on Oni [[wp:Video game modding|modding]]; for an introduction to how to actually mod Oni, see [[Introduction to modding|here]]. To download mods, you can start [[AE|here]].}}
As has been documented on the page about [[Oni]]'s overall development, time ran out for Bungie West to do everything they wanted with this very ambitious game. Just as some features had to be omitted, the promise of modding support<ref>In [[Harry]]'s [http://oni.bungie.org/special/part1/brent.html interview], Brent Pease, the Project Lead, said: "What we will do is, I'm about 90 percent sure of this, is give away the file format." He also promises with equal certainty that the tools for converting 3D Studio Max models into Oni models will be given away. Pease eventually left the project before its completion. Hardy LeBel, his replacement, would later say, "[Due to the time crunch] our primary focus had to be on completing the content and features of the game rather than building in support for the mod community." Additionally, Bungie no longer owned the game by the time it shipped, so it would have been legally questionable to release header files from the source code, which would be the simplest and quickest way to "give away the file format".</ref> also failed to come true. However, even before Oni fans realized that there would never be official modding tools from Bungie, they were already eagerly diving into the game data to see how they could mod it.<ref>Fans wasted no time in dumping the readable text from the executable and trying to figure out how to enable Developer Mode, starting before Oni's official release date by analyzing the demo. Little did they know it would take another five years before this particular goal would be reached.</ref> Nevertheless, the lack of any documentation or tools for modding undeniably slowed the development of mods within the community. Only since 2010 has the community's modding capabilities covered nearly all aspects of the game.

There are three basic areas in which the game can be modded: scripting, binary resources, and the engine itself. Along the way, we'll look at some key discoveries the community made in more detail.

==BSL scripting==
[[Image:One Tiny Mistake.jpg|thumb|225px|right|Konoko pulls her gun on the secretary in the beginning of Chapter 2, a change to the original cutscene made by a script which tightens up the story and provides a new challenge for veteran players.]]
Since the .bsl files were in plain text and in plain sight within the folders that held Oni's game data, it's not surprising that fans quickly learned some basic scripting commands by seeing what Bungie had written, and started making their own scripts. Further commands were discovered by dumping readable text from the engine, although not everything worked as it seemed it should.

As scripters were learning [[BSL]], they produced scripts that at first merely modified the original level logic in minor ways. Then they produced more original, often epic fight scripts; later, some ambitious modders scripted totally new objectives and mission layouts (e.g., Mariachi Bear's alternate storyline). Some of the most complex scripts are the [[OTA]] scripts which were eventually developed to make up for a lack of multiplayer gameplay.

However, fully original scripts are all the more prone to bugs. The first two are easier to set up, but extreme situations tend to overload the engine (as in "[[Blam!]]") in ways that scripters have trouble preventing. Testing the scripts required numerous reloads of the game. The process became much faster when the Developer Mode console was unlocked (see {{SectionLink||Finding Dev Mode}}) and individual commands could be tested easily.

While scripting is the easiest way to mod Oni, it's also the most limited, because scripts can only utilize the resources that the vanilla level has to offer.
{{clearall}}
==Binary resources==
===Private knowledge, public results===
[[Image:OniTools.jpg|thumb|225px|right|Ian Patterson's trailblazing Mac program OniTools was eagerly ported to Windows by other fans.]]
[[Image:OUP_txmpreplace.jpg|thumb|225px|right|OniUnPacker by Alloc, premiering in fall of 2005, provided a simple interface for finding the resource you wanted and displaying it, as well as replacing it.]]
[[Image:AE_Installer_1.jpg|thumb|225px|right|The AE mod installer released in 2009. For the first time, players could pick and choose what mods to install.]]
[[Image:AEI_main_window.jpg|thumb|225px|right|The AE Installer released in 2013 could update itself, the player's mods, and the patches made to the game. It was written from scratch in Java for ease of cross-platform support.]]
Fans with some expertise in parsing files with hex editors found that the level data files held four-letter codes indicating the start of each resource within that file. Before Oni even released, the community had its first resource modding tool, Ian Patterson's [[OniTools]]. While the author did not yet know how all the data worked, his program could at least parse it, and allow the modder to more easily edit each resource without having to count in hexadecimal. It also supported user-friendly replacement of texture maps, delta patches called CMPOs, and allowed inline viewing of the game's 3D models. There seems to be little evidence that this knowledge was put to use in modding the game resources beyond simple texture replacements, no doubt due to the lack of a complete understanding of how Oni's dozens of resource types were interrelated. But the open-source release of OniTools gave fans something to build on.

Independently, an intrepid programmer named Pierre Terdiman decided to import data from Oni into the game engine that he was writing from scratch. Called [[Konoko Payne]], it was a long-term project which took the form of (1) an underlying engine and (2) a short scenario for it that resembled a sequel to Oni. In order to extract models and animations from Oni and recreate them precisely in his project, Pierre became one of the early pioneers in reverse-engineering the game's resources, although his acquired knowledge remained largely private as the engine was closed-source.

===Hackers unite===
Perhaps the first place that knowledge of Oni's data was directly published online was on [http://oni.moltenstudios.com/tool/index.php Oni Master's site], which started as early as 2003 and was based on the source code for OniTools. Then, in 2005, [[User talk:Ssg|Ssg]] opened a site with a much more thorough examination of the game data (the site is now hosted at http://ssg.oni2.net). Later that year, this pool of knowledge was painstakingly moved by [[User:Geyser|geyser]] and Ssg to its final home on the newly-opened wiki OniGalore. The purpose of creating the [[OBD|Oni Binary Database]] was to allow collaboration, and soon [[User talk:Neo|Neo]] appeared on the scene, adding his own knowledge that he had been acquiring independently until then, and collaborating on further investigations into the resource formats. Today at least 95% of the binary resource formats are documented byte for byte thanks to their hard work.
:''Further reading:'' {{SectionLink|History of the Oni community|2005}}.

===Modding by candlelight===
Originally, modders had to alter these binary resources manually with hex editors to adapt them to their scripts. [[User:Loser|Loser]] was the first modder to manually edit the game data to go along with his scripting, creating a massively reshuffled Warehouse. Loser's [[AE:Warehouse|Warehouse mod]] included a global component (modified level0_Final), level-specific binary modifications, and a set of customized scripts that took full advantage of the modified binaries.

Minor binary modding had already occurred before Loser's Warehouse (thus, while compiling the [[OBD]] database, Ssg had released a version of level0_Final in which all of Konoko's combos were unlocked). Still, it was the Warehouse mod released in 2005 which first showed the "full" potential of binary modding. It inspired a short-lived initiative called the [[AE:BIP|Binary Improvement Project]] (BIP), aimed at providing upgraded binaries for all levels, not just level0_Final and level1_Final.

BIP was hindered by large upload/download sizes as well as by the potential legal issues involved in distributing entire files from the game; in 2006 it was replaced by a smarter alternative to supplying whole levels, in the form of [[OUP|OniUnPacker]]-based patches, and was termed [[AE:ONK|Oni ni Kanabô]] (ONK). The modder would edit his .dat/.raw files in OUP, and then release a single binary resource patch. This was both bandwidth-efficient and more legal-friendly, but suffered from one major limitation: the indexation and offsets of data vary a lot across the available versions of Oni. Thus, resources exported with OUP were not truly standalone or portable. Also, OUP still lacked the ability to import new resources alongside existing ones.

===Modular modding===
The advent of Neo's [[OniSplit]] in late 2007 marked a radical improvement to the community's modding methods. A command-line tool that runs on Windows and Macs, OniSplit breaks Oni's resources into standalone files, making mods truly portable across different retail versions of Oni. These resources can be exported to standard formats as text, images, sounds and 3D models, which after editing can be recombined into the level data files that Oni expects, and newly-made resources can also be packed into the level data. To take advantage of this revolution in modding, geyser began preparing an OniSplit-based port of some of the work done on BIP and ONK, which he hoped would be ready for the seventh anniversary of Oni's release in January 2008.

This "[[AE|Seventh Anniversary Edition]]" had major releases in January and July 2008. The tradition continued of using a central modding project to organize a general revision of Oni's content, as seen on pages like [[AE:Ninja]]. The project then changed hands to [[User:Gumby|Gumby]], who designed a framework and a GUI-based installer that allowed players to selectively install only the modifications that they wanted. This mostly moved the project away from a centralized improvement effort, though select mods were still bundled with the download. Since Oni's seventh anniversary had come and gone, the mod collection was renamed simply the "Anniversary Edition", aka the "Edition" or the "AE". Released in July 2009, the new AE's framework allowed modders to create their own "[[Making a mod package|mod packages]]". These could be stored on the {{OMD}}, then downloaded by the player and placed in a certain folder in order to see them in the Installer. Another release was made in May 2010 with more bundled mods and an improved framework.

Nothing new took place on this front until 2013, by which time the project had fallen into [[User:Iritscen|Iritscen's]] hands due to the retirement of geyser and Gumby. At this time, the release of the new AE included a brand-new Installer written by Alloc which could connect to the Mod Depot, offer all mod packages for download, and update the mods and patches already installed. The program [[XmlTools]] was developed by [[User:Script 10k|s10k]] to allow "patch modding" of resources in order to avoid conflicts when different mods attempted to modify the same resource. The AE's bundled content was stripped down to only minimal fixes for the first time, making all notable game modifications into optional third-party mods and ceasing any attempt at centralized game data improvement.

===New content===
Certain game resources were easy enough to reverse-engineer that the community was able to mod them almost from the time of Oni's release, such as textual resources and textures. Some game resources, however, were complex and involved multiple data types, such as character models, and, most obviously, levels themselves. These took a number of years to decipher.

OniSplit first gained the ability to import new character models in April 2008.<ref>See [[User talk:Neo/Archive2]].</ref> At first, since the focus was on the technical side of things, pre-existing models were used, either by modifying Oni's models, or by finding royalty-free models on web sites and converting them to Oni's 19-bone system. A more dramatic use of the character-importing ability came with the creation of a high-detail Konoko model from scratch in October 2010.<ref>[http://web.archive.org/web/20220524143515/http://oni.bungie.org/forum/viewtopic.php?id=1727 OCF thread, "Konoko HD"].</ref>

A major obstacle with levels was the question of how to generate pathfinding (PF) grids for the AI. Level geometry could be imported fairly easily as of November 2008,<ref>See [[User talk:Neo/Archive5]].</ref> but AIs could not navigate the level. Manual PF grid creation was first demonstrated with the creation of the Arena level in November 2010.<ref>[http://web.archive.org/web/20210117150652/http://oni.bungie.org/forum/viewtopic.php?id=1736 OCF thread, "Arena Level"].</ref> Automatic PF grid generation was introduced to OniSplit around June 2011. More comprehensive demonstrations of the community's level creation abilities came with [[User:EdT|EdT]]'s level "Muro's Lair" in August 2011<ref>[http://web.archive.org/web/20201029113340/http://oni.bungie.org/forum/viewtopic.php?id=2024 OCF thread, "Muro's Lair - Preview"].</ref> and [[User:Samer|Samer]]'s level "Wilderness Preserve" in January 2014.<ref>[http://web.archive.org/web/20211202225410/http://oni.bungie.org/forum/viewtopic.php?id=2698 OCF thread, "NEW LEVEL : Chapter 17: Wilderness Preserve - Hasegawa Adventure"].</ref>

Work continues in all areas of modding Oni, as well as documenting the modding process.
{{clearall}}
==Engine patching==
===Finding Dev Mode===
[[Image:Sfeli Finds Dev Mode.jpg|thumb|225px|right|[[User talk:SFeLi|SFeLi]] documents his discovery in 2006: in examining the binary, he noticed that the list of cheat codes had a gap in it where one cheat had been deactivated – that code was for Developer Mode. For more history, see [[/The tale of Dev Mode|The tale of Dev Mode]].]]
Engine patching is needed when modders want to do things the game's scripts and data do not currently allow for, as well as to fix bugs. Bug fixes were the earliest notable achievement in engine patching, originally performed by a patching application that altered the Windows Oni executable directly, but a revolution in this type of modding occurred in 2006 when [[Developer Mode]] was finally discovered in retail Oni's code, and a means for unlocking it was needed.

The most foolproof method of altering the engine turned out to be replacing a library that Oni loads at runtime. Originally this was done by placing a library next to Oni.exe called vtuneapi.dll, which contained code written by SFeLi that would replace or patch functions in Oni. This library came to be known as the [[Daodan DLL]]. The code for it was ported from assembly language to C by RossyMiles. Eventually the decision was made to instead replace binkw32.dll (the library for playing Oni's intro and outro movies) because it loaded earlier in Oni's launch sequence. The DLL was later developed by Gumby and then Alloc, fixing more bugs (some of which result from modern computers running a {{Age|2001|1|29}}-year-old game), as well as adding new features. The DLL's features and settings are documented on the page for the DLL linked above.

Not long after the Daodan DLL was released for Windows Oni, it was discovered that the Mac versions of Oni still had Dev Mode in them, too. Instead of replacing the Bink Carbon Library that came with Mac Oni, the Omni Group port of the game application to Mac OS X was patched directly with a hex editor. In the fall of 2008, it was discovered that numerous BSL functions and variables that were thought to be removed from Oni for the Mac [[Mac beta 4|before release]] were still present in the code, and the ones which allowed Macs to run (almost) all scripts written for Windows Oni were "unlocked" by EdT using hex edits. Certain changes made by the Daodan DLL for the Windows version were also carried over to the Mac's [[OMNI|PPC game application]] in hex-edit form with Neo's assistance. Later, these changes were made in source for Feral Interactive's [[FERAL|Mac Intel port]].

===Bug fixes===
One of the most visible changes to the game that the Daodan DLL (and equivalent hex edits on the Mac side) made possible came about in July '07 when an error in Oni's AI routines was corrected by Neo, allowing the AI to dodge incoming fire more consistently. Fans had originally been disappointed to see the AI often run blindly into oncoming gunfire. With Neo's patch in place, previously glitched code now works as intended, allowing the AI to dodge projectiles by taking cover.

===Multiplayer===
The most ambitious use of engine patching has been to fill in for Oni's [[Multiplayer|missing multiplayer mode]]. In Windows this was done through the Daodan DLL by the [[Flatline]] project, which saw a rough alpha released in 2010. In Mac OS X, the [[Zukai]] project operated on a Mac equivalent of the Daodan DLL and released a rough alpha in 2015.

===New engine builds===
A new era in Oni's life began with the introduction in 2021 of [[OniX]], a rebuild of the game engine. It remains to be seen how far this development work will take Oni, but in theory the possibilities are almost endless.

----

==Footnotes==
<references/>

[[Category:Community history]]

Anniversary Edition/To-do

2025-12-26T06:16:16Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{| class="wikitable"
!width="300px"| Task
!Description
|-
|Support the Oni demo
|If the AEI can install mods into the demo's 2 or 3 level set, it would be nice advertising. The demo data can even be automatically installed through the AEI.
|-
|Turn previously-core mods into optional mods
|Packages can be marked as "Standard fixes" so user is more inclined to install them.
|-
|Consider salvaging the animation mods that were bundled with AE 2010 as [https://websvn.illy.bz/browse/Oni2/AE/packages/ optional packages]
|
*Upgraded ONCCs - Make into patch mod if this is still valuable.
*Andrashi TRAMs - Loser [http://web.archive.org/web/20160225141425/http://oni.bungie.org/forum/viewtopic.php?pid=43490#p43490 seems to want] them to be forgotten; there are numerous issues reported for them, such as [http://web.archive.org/web/20160225192420/http://oni.bungie.org/forum/viewtopic.php?pid=27161#p27161 here] and [http://oni.bungie.org/forum/viewtopic.php?pid=36174#p36174 here]. See discussion of his and love_Oni's changes [http://web.archive.org/web/20160225025818/http://oni.bungie.org/forum/viewtopic.php?id=2576 here].
|-
|Raise femcop health in Upgraded ONCCs
|We have multiple reports that Karen et al. have way too low health in this pkg
|-
|Fix damage for TCTF back throw
|Damage frame [http://oni.bungie.org/forum/viewtopic.php?pid=45791#p45791 is outside] the actual animation!
|-
|Fix numerous issues with OTA mod packages
|Issues are listed [[AE talk:OTA|HERE]].
|-
|Review HQ movie packages for Mac/Win
|Why are the movies 512x384 when the PS2 masters were 640x480?
|-
|Upgrade HD Screens with larger screens
|Modern resolutions make the 1024x768 screens look tiny.
|-
|Add support for BSL patches
|A BSL patch would include context like the function name, surrounding lines, and a number meaning "''n''th occurrence of text". This would allow us to actually modify the same BSL file with more than one mod.
|-
|Straighten out melee profiles
|Custom characters' profiles and the Brutal AI profiles are all over the place. See [http://web.archive.org/web/20160224173705/http://oni.bungie.org/forum/viewtopic.php?id=2941 this thread].
|}

[[Category:Anniversary Edition]]

Anniversary Edition/To-do

2025-12-26T06:16:09Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{| class="wikitable"
!width="300px"| Task
!Description
|-
|Support the Oni demo
|If the AEI can install mods into the demo's 2 or 3 level set, it would be nice advertising. The demo data can even be automatically installed through the AEI.
|-
|Turn previously-core mods into optional mods
|Packages can be marked as "Standard fixes" so user is more inclined to install them.
|-
|Consider salvaging the animation mods that were bundled with AE 2010 as [https://websvn.illy.bz/browse/Oni2/AE/packages/ optional packages]
|
*Upgraded ONCCs - Make into patch mod if this is still valuable.
*Andrashi TRAMs - Loser [http://oni.bungie.org/forum/viewtopic.php?pid=43490#p43490 seems to want] them to be forgotten; there are numerous issues reported for them, such as [http://web.archive.org/web/20160225192420/http://oni.bungie.org/forum/viewtopic.php?pid=27161#p27161 here] and [http://oni.bungie.org/forum/viewtopic.php?pid=36174#p36174 here]. See discussion of his and love_Oni's changes [http://web.archive.org/web/20160225025818/http://oni.bungie.org/forum/viewtopic.php?id=2576 here].
|-
|Raise femcop health in Upgraded ONCCs
|We have multiple reports that Karen et al. have way too low health in this pkg
|-
|Fix damage for TCTF back throw
|Damage frame [http://oni.bungie.org/forum/viewtopic.php?pid=45791#p45791 is outside] the actual animation!
|-
|Fix numerous issues with OTA mod packages
|Issues are listed [[AE talk:OTA|HERE]].
|-
|Review HQ movie packages for Mac/Win
|Why are the movies 512x384 when the PS2 masters were 640x480?
|-
|Upgrade HD Screens with larger screens
|Modern resolutions make the 1024x768 screens look tiny.
|-
|Add support for BSL patches
|A BSL patch would include context like the function name, surrounding lines, and a number meaning "''n''th occurrence of text". This would allow us to actually modify the same BSL file with more than one mod.
|-
|Straighten out melee profiles
|Custom characters' profiles and the Brutal AI profiles are all over the place. See [http://web.archive.org/web/20160224173705/http://oni.bungie.org/forum/viewtopic.php?id=2941 this thread].
|}

[[Category:Anniversary Edition]]

Regenerating Tanker

2025-12-26T06:15:25Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

The '''Regenerating Tanker''' is a custom character by [[User:Samer|Samer]]. His personal name is Brontes. The concept is that he's a [[Tanker]] with the ability to regenerate health like [[Barabas]], and that he is the Syndicate commander and pro wrestling fan on whom the Tanker SLDs were [[Quotes/Manual#Tanker_Green|later based]]. Brontes, [[Kojiro]] and [[Regenerating Fury|Eris the Regenerating Fury]] make up the [[Saisei Team]]. The mod can be found [http://web.archive.org/web/20211202230746/http://oni.bungie.org/forum/viewtopic.php?id=2046 here].

[[Image:Regenerating Tanker.jpg|800px]]

[[Category:Syndicate]][[Category:Modding projects]]

User:Samer

2025-12-26T06:15:13Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

==About Me==
Real Name : Samer Khodor

I've been an Oni fan for a long time and ever since I first finished the game I hoped that one day I'll see new content brought into Oni. This dream became a reality when I found Oni Central Forum, I then picked up modding and I enjoyed making new characters so much that I started making a lot of character mods ever since.

I'm a pharmacist but computers and digital art have always been a passion of mine. I never had any experience modding any other game or using XSI before I started modding Oni.
I've been actively modding since 2009.

===Oni Facebook Group===
I've also started an Oni Facebook group that I regularly update with news about new mods, screenshots and videos from the forum. It has about 300 members at the moment. Here's a link to the group [https://m.facebook.com/groups/186656799756?refid=27 Oni "The Action Game"] You need a facebook account to see the posts.

===Videos===
For my Oni videos check [https://www.youtube.com/channel/UCtTcOh2t7wRZ5rXzMmWt6xA My Oni YouTube Channel ]

==Mods==
My first mod was simple TRAC replacement of Halo Master Chief .. second one was [[Konoko]] violet fury, a simple TRBS and texture replacement, both with [[User:EdT| EdT]]'s help .. The first unique and complete character I made was [[Shinatama Evolved]], followed by [[Casey]].

You can use the AEInstaller to arrange mods by Creator and see all of the mods I've made or contributed to, the description usually includes a link to that mod's forum thread, and sometimes a youtube showcase video.

You can also click on some of the names of the characters mentioned below to open their wiki page for more information about them, and you'll also find a link to their corresponding mod page there.

===Single Custom Character Mods===
* [[Shinatama Evolved]]
* [[Casey]]
* [[Kojiro]]
* Hayate and Hayate minions
* Hanako
* Jester and Co.
* James and Jamie Hasegawa
* Golden TCTF
* BGI [[Sarai]]
* [[BGI_characters#BGI_Hammer|BGI Hammer]] (in collaboration with [[User:Ltemplar|Ltemplar]])
* [[BGI_characters#BGI_Agents|BGI Agents]]
* [[BGI_characters#BGI_NinjaBot|BGI NinjaBot]]
* [[BGI_characters#BGI_Heavy_Bot|BGI Heavy Bot]] ([[AE:BGI#Candidate|original concept]] by [[User:Geyser|geyser]])
* [[Regenerating Fury]] (original by [[User:Paradox-01|Paradox-01]])
* [[Regenerating Tanker]]
* [[Casual Tankers]]
* Blackops FemCops and Konoko Blackops outfit
* Muro's Wardrobe
* Rayman

===Sam Mega Pack Mods===
Or SMP Mods for short, this is a series of mods that utilize the custom characters I've made or contributed to.

====Sam Mega Pack Conversion====
This mod basically incorporates the custom characters into the main game's story and levels, making it more deep and challenging.
Some Examples:
*Casey appears as partner in the earlier levels and as a foe in TCTF HQ Redux and dream lab.
*Hayate and Hanako are utilized as Mukade's comrades making appearances in Regional State Building, Rooftops and dream lab.
*Regenerating Fury, Kojiro and Regenerating Tanker appear as sub-bosses in some levels example Regenerating Fury will be guarding Shinatama in Atmospheric Center Interior.
*Konoko's parents make an appearance in Dream Lab.
*Golden TCTFs are incorporated into SC prison and TCTF HQ Redux.

====Sam Mega Pack FightClub====
A new level made in collaboration with EdT and s10k.
Multiple rounds of increasing difficulty fighting the custom characters and some vanilla characters.
Including : Casey, SkullTeam, Hayate, Hanako, Jesters, Rayman etc ...

===Other Mods===
====Hidden Treasure Challenge====
This mod hides Rayman fist weapon in each of the levels, in hard to reach places.
Using the riddles provided and some parkour skills player is supposed to find the hidden weapon in each level.

====Character Texturing====
*[http://web.archive.org/web/20220524143847/http://oni.bungie.org/forum/viewtopic.php?id=1807 Character Re-texture Package] : this package enhances the textures of several Oni characters including, TCTF light, heavy, blackops, Female and Male cops, scientists and civilians, Comguys Mad Bomber, Tankers, Furies, Security guards.
This project is a combination of efforts by Severed, Bozzman and myself.

some samples :

https://lh5.googleusercontent.com/-FBlR4brYzss/UCC5GkP2C0I/AAAAAAAACFA/n55yExqIO5Y/s800/2012-08-06_191136.jpg
https://lh4.googleusercontent.com/-sham2riMXW4/UCC5lQsms1I/AAAAAAAACFQ/l0VH8pYPDFQ/s800/2012-08-06_201215.jpg

the blackops uniforms shown here are by Bozzman, and the male cops uniform is based on SeverED's Konoko cop outfit.

==Other contributions==
===Oni Joint Story===
I took part in writing the [[Joint Story|Oni Joint Story]] along with Leus and Mukade, whose events take place after the game ends .. and in introducing new characters such as BGI female boss .. Samako as Leus named her, better known as Sarai now.

===Tutorials===
I'm currently working on writing this tutorial [http://web.archive.org/web/20160224202204/http://oni.bungie.org/forum/viewtopic.php?id=2423 Making a Custom Character From Start to Finish]. I will import it to the Wiki once it's completely done.

[[Category:Userspace]]

Shinatama Evolved

2025-12-26T06:15:05Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

'''Shinatama Evolved''' is a custom playable character developed by [[User:Samer|Samer]]. The idea is that [[Shinatama]] got rebuilt/resurrected into a more combat-ready body, maybe as a way for Griffin to redeem himself when Konoko spared his life in the bunker, or perhaps Konoko managed to bring back Shinatama by other means.

The playable character comes with 6 variants, a custom move set, and utilizes the in-game Shinatama sounds for taunts and hurt sounds. It is available [http://web.archive.org/web/20220813114527/http://oni.bungie.org/forum/viewtopic.php?id=1240 here]. The outfit on the left is based on DarkLitria's [[:Image:DarkLitria - Shini3.png|sketch]] of a mature Shinatama.

[[Image:Shinatama Evolved.jpg]]

[[Category:Modding projects]]

User:Samer

2025-12-26T06:14:57Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

==About Me==
Real Name : Samer Khodor

I've been an Oni fan for a long time and ever since I first finished the game I hoped that one day I'll see new content brought into Oni. This dream became a reality when I found Oni Central Forum, I then picked up modding and I enjoyed making new characters so much that I started making a lot of character mods ever since.

I'm a pharmacist but computers and digital art have always been a passion of mine. I never had any experience modding any other game or using XSI before I started modding Oni.
I've been actively modding since 2009.

===Oni Facebook Group===
I've also started an Oni Facebook group that I regularly update with news about new mods, screenshots and videos from the forum. It has about 300 members at the moment. Here's a link to the group [https://m.facebook.com/groups/186656799756?refid=27 Oni "The Action Game"] You need a facebook account to see the posts.

===Videos===
For my Oni videos check [https://www.youtube.com/channel/UCtTcOh2t7wRZ5rXzMmWt6xA My Oni YouTube Channel ]

==Mods==
My first mod was simple TRAC replacement of Halo Master Chief .. second one was [[Konoko]] violet fury, a simple TRBS and texture replacement, both with [[User:EdT| EdT]]'s help .. The first unique and complete character I made was [[Shinatama Evolved]], followed by [[Casey]].

You can use the AEInstaller to arrange mods by Creator and see all of the mods I've made or contributed to, the description usually includes a link to that mod's forum thread, and sometimes a youtube showcase video.

You can also click on some of the names of the characters mentioned below to open their wiki page for more information about them, and you'll also find a link to their corresponding mod page there.

===Single Custom Character Mods===
* [[Shinatama Evolved]]
* [[Casey]]
* [[Kojiro]]
* Hayate and Hayate minions
* Hanako
* Jester and Co.
* James and Jamie Hasegawa
* Golden TCTF
* BGI [[Sarai]]
* [[BGI_characters#BGI_Hammer|BGI Hammer]] (in collaboration with [[User:Ltemplar|Ltemplar]])
* [[BGI_characters#BGI_Agents|BGI Agents]]
* [[BGI_characters#BGI_NinjaBot|BGI NinjaBot]]
* [[BGI_characters#BGI_Heavy_Bot|BGI Heavy Bot]] ([[AE:BGI#Candidate|original concept]] by [[User:Geyser|geyser]])
* [[Regenerating Fury]] (original by [[User:Paradox-01|Paradox-01]])
* [[Regenerating Tanker]]
* [[Casual Tankers]]
* Blackops FemCops and Konoko Blackops outfit
* Muro's Wardrobe
* Rayman

===Sam Mega Pack Mods===
Or SMP Mods for short, this is a series of mods that utilize the custom characters I've made or contributed to.

====Sam Mega Pack Conversion====
This mod basically incorporates the custom characters into the main game's story and levels, making it more deep and challenging.
Some Examples:
*Casey appears as partner in the earlier levels and as a foe in TCTF HQ Redux and dream lab.
*Hayate and Hanako are utilized as Mukade's comrades making appearances in Regional State Building, Rooftops and dream lab.
*Regenerating Fury, Kojiro and Regenerating Tanker appear as sub-bosses in some levels example Regenerating Fury will be guarding Shinatama in Atmospheric Center Interior.
*Konoko's parents make an appearance in Dream Lab.
*Golden TCTFs are incorporated into SC prison and TCTF HQ Redux.

====Sam Mega Pack FightClub====
A new level made in collaboration with EdT and s10k.
Multiple rounds of increasing difficulty fighting the custom characters and some vanilla characters.
Including : Casey, SkullTeam, Hayate, Hanako, Jesters, Rayman etc ...

===Other Mods===
====Hidden Treasure Challenge====
This mod hides Rayman fist weapon in each of the levels, in hard to reach places.
Using the riddles provided and some parkour skills player is supposed to find the hidden weapon in each level.

====Character Texturing====
*[http://oni.bungie.org/forum/viewtopic.php?id=1807 Character Re-texture Package] : this package enhances the textures of several Oni characters including, TCTF light, heavy, blackops, Female and Male cops, scientists and civilians, Comguys Mad Bomber, Tankers, Furies, Security guards.
This project is a combination of efforts by Severed, Bozzman and myself.

some samples :

https://lh5.googleusercontent.com/-FBlR4brYzss/UCC5GkP2C0I/AAAAAAAACFA/n55yExqIO5Y/s800/2012-08-06_191136.jpg
https://lh4.googleusercontent.com/-sham2riMXW4/UCC5lQsms1I/AAAAAAAACFQ/l0VH8pYPDFQ/s800/2012-08-06_201215.jpg

the blackops uniforms shown here are by Bozzman, and the male cops uniform is based on SeverED's Konoko cop outfit.

==Other contributions==
===Oni Joint Story===
I took part in writing the [[Joint Story|Oni Joint Story]] along with Leus and Mukade, whose events take place after the game ends .. and in introducing new characters such as BGI female boss .. Samako as Leus named her, better known as Sarai now.

===Tutorials===
I'm currently working on writing this tutorial [http://web.archive.org/web/20160224202204/http://oni.bungie.org/forum/viewtopic.php?id=2423 Making a Custom Character From Start to Finish]. I will import it to the Wiki once it's completely done.

[[Category:Userspace]]

History of Oni modding

2025-12-26T06:14:50Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{Hatnote|This article is a historical perspective on Oni [[wp:Video game modding|modding]]; for an introduction to how to actually mod Oni, see [[Introduction to modding|here]]. To download mods, you can start [[AE|here]].}}
As has been documented on the page about [[Oni]]'s overall development, time ran out for Bungie West to do everything they wanted with this very ambitious game. Just as some features had to be omitted, the promise of modding support<ref>In [[Harry]]'s [http://oni.bungie.org/special/part1/brent.html interview], Brent Pease, the Project Lead, said: "What we will do is, I'm about 90 percent sure of this, is give away the file format." He also promises with equal certainty that the tools for converting 3D Studio Max models into Oni models will be given away. Pease eventually left the project before its completion. Hardy LeBel, his replacement, would later say, "[Due to the time crunch] our primary focus had to be on completing the content and features of the game rather than building in support for the mod community." Additionally, Bungie no longer owned the game by the time it shipped, so it would have been legally questionable to release header files from the source code, which would be the simplest and quickest way to "give away the file format".</ref> also failed to come true. However, even before Oni fans realized that there would never be official modding tools from Bungie, they were already eagerly diving into the game data to see how they could mod it.<ref>Fans wasted no time in dumping the readable text from the executable and trying to figure out how to enable Developer Mode, starting before Oni's official release date by analyzing the demo. Little did they know it would take another five years before this particular goal would be reached.</ref> Nevertheless, the lack of any documentation or tools for modding undeniably slowed the development of mods within the community. Only since 2010 has the community's modding capabilities covered nearly all aspects of the game.

There are three basic areas in which the game can be modded: scripting, binary resources, and the engine itself. Along the way, we'll look at some key discoveries the community made in more detail.

==BSL scripting==
[[Image:One Tiny Mistake.jpg|thumb|225px|right|Konoko pulls her gun on the secretary in the beginning of Chapter 2, a change to the original cutscene made by a script which tightens up the story and provides a new challenge for veteran players.]]
Since the .bsl files were in plain text and in plain sight within the folders that held Oni's game data, it's not surprising that fans quickly learned some basic scripting commands by seeing what Bungie had written, and started making their own scripts. Further commands were discovered by dumping readable text from the engine, although not everything worked as it seemed it should.

As scripters were learning [[BSL]], they produced scripts that at first merely modified the original level logic in minor ways. Then they produced more original, often epic fight scripts; later, some ambitious modders scripted totally new objectives and mission layouts (e.g., Mariachi Bear's alternate storyline). Some of the most complex scripts are the [[OTA]] scripts which were eventually developed to make up for a lack of multiplayer gameplay.

However, fully original scripts are all the more prone to bugs. The first two are easier to set up, but extreme situations tend to overload the engine (as in "[[Blam!]]") in ways that scripters have trouble preventing. Testing the scripts required numerous reloads of the game. The process became much faster when the Developer Mode console was unlocked (see {{SectionLink||Finding Dev Mode}}) and individual commands could be tested easily.

While scripting is the easiest way to mod Oni, it's also the most limited, because scripts can only utilize the resources that the vanilla level has to offer.
{{clearall}}
==Binary resources==
===Private knowledge, public results===
[[Image:OniTools.jpg|thumb|225px|right|Ian Patterson's trailblazing Mac program OniTools was eagerly ported to Windows by other fans.]]
[[Image:OUP_txmpreplace.jpg|thumb|225px|right|OniUnPacker by Alloc, premiering in fall of 2005, provided a simple interface for finding the resource you wanted and displaying it, as well as replacing it.]]
[[Image:AE_Installer_1.jpg|thumb|225px|right|The AE mod installer released in 2009. For the first time, players could pick and choose what mods to install.]]
[[Image:AEI_main_window.jpg|thumb|225px|right|The AE Installer released in 2013 could update itself, the player's mods, and the patches made to the game. It was written from scratch in Java for ease of cross-platform support.]]
Fans with some expertise in parsing files with hex editors found that the level data files held four-letter codes indicating the start of each resource within that file. Before Oni even released, the community had its first resource modding tool, Ian Patterson's [[OniTools]]. While the author did not yet know how all the data worked, his program could at least parse it, and allow the modder to more easily edit each resource without having to count in hexadecimal. It also supported user-friendly replacement of texture maps, delta patches called CMPOs, and allowed inline viewing of the game's 3D models. There seems to be little evidence that this knowledge was put to use in modding the game resources beyond simple texture replacements, no doubt due to the lack of a complete understanding of how Oni's dozens of resource types were interrelated. But the open-source release of OniTools gave fans something to build on.

Independently, an intrepid programmer named Pierre Terdiman decided to import data from Oni into the game engine that he was writing from scratch. Called [[Konoko Payne]], it was a long-term project which took the form of (1) an underlying engine and (2) a short scenario for it that resembled a sequel to Oni. In order to extract models and animations from Oni and recreate them precisely in his project, Pierre became one of the early pioneers in reverse-engineering the game's resources, although his acquired knowledge remained largely private as the engine was closed-source.

===Hackers unite===
Perhaps the first place that knowledge of Oni's data was directly published online was on [http://oni.moltenstudios.com/tool/index.php Oni Master's site], which started as early as 2003 and was based on the source code for OniTools. Then, in 2005, [[User talk:Ssg|Ssg]] opened a site with a much more thorough examination of the game data (the site is now hosted at http://ssg.oni2.net). Later that year, this pool of knowledge was painstakingly moved by [[User:Geyser|geyser]] and Ssg to its final home on the newly-opened wiki OniGalore. The purpose of creating the [[OBD|Oni Binary Database]] was to allow collaboration, and soon [[User talk:Neo|Neo]] appeared on the scene, adding his own knowledge that he had been acquiring independently until then, and collaborating on further investigations into the resource formats. Today at least 95% of the binary resource formats are documented byte for byte thanks to their hard work.
:''Further reading:'' {{SectionLink|History of the Oni community|2005}}.

===Modding by candlelight===
Originally, modders had to alter these binary resources manually with hex editors to adapt them to their scripts. [[User:Loser|Loser]] was the first modder to manually edit the game data to go along with his scripting, creating a massively reshuffled Warehouse. Loser's [[AE:Warehouse|Warehouse mod]] included a global component (modified level0_Final), level-specific binary modifications, and a set of customized scripts that took full advantage of the modified binaries.

Minor binary modding had already occurred before Loser's Warehouse (thus, while compiling the [[OBD]] database, Ssg had released a version of level0_Final in which all of Konoko's combos were unlocked). Still, it was the Warehouse mod released in 2005 which first showed the "full" potential of binary modding. It inspired a short-lived initiative called the [[AE:BIP|Binary Improvement Project]] (BIP), aimed at providing upgraded binaries for all levels, not just level0_Final and level1_Final.

BIP was hindered by large upload/download sizes as well as by the potential legal issues involved in distributing entire files from the game; in 2006 it was replaced by a smarter alternative to supplying whole levels, in the form of [[OUP|OniUnPacker]]-based patches, and was termed [[AE:ONK|Oni ni Kanabô]] (ONK). The modder would edit his .dat/.raw files in OUP, and then release a single binary resource patch. This was both bandwidth-efficient and more legal-friendly, but suffered from one major limitation: the indexation and offsets of data vary a lot across the available versions of Oni. Thus, resources exported with OUP were not truly standalone or portable. Also, OUP still lacked the ability to import new resources alongside existing ones.

===Modular modding===
The advent of Neo's [[OniSplit]] in late 2007 marked a radical improvement to the community's modding methods. A command-line tool that runs on Windows and Macs, OniSplit breaks Oni's resources into standalone files, making mods truly portable across different retail versions of Oni. These resources can be exported to standard formats as text, images, sounds and 3D models, which after editing can be recombined into the level data files that Oni expects, and newly-made resources can also be packed into the level data. To take advantage of this revolution in modding, geyser began preparing an OniSplit-based port of some of the work done on BIP and ONK, which he hoped would be ready for the seventh anniversary of Oni's release in January 2008.

This "[[AE|Seventh Anniversary Edition]]" had major releases in January and July 2008. The tradition continued of using a central modding project to organize a general revision of Oni's content, as seen on pages like [[AE:Ninja]]. The project then changed hands to [[User:Gumby|Gumby]], who designed a framework and a GUI-based installer that allowed players to selectively install only the modifications that they wanted. This mostly moved the project away from a centralized improvement effort, though select mods were still bundled with the download. Since Oni's seventh anniversary had come and gone, the mod collection was renamed simply the "Anniversary Edition", aka the "Edition" or the "AE". Released in July 2009, the new AE's framework allowed modders to create their own "[[Making a mod package|mod packages]]". These could be stored on the {{OMD}}, then downloaded by the player and placed in a certain folder in order to see them in the Installer. Another release was made in May 2010 with more bundled mods and an improved framework.

Nothing new took place on this front until 2013, by which time the project had fallen into [[User:Iritscen|Iritscen's]] hands due to the retirement of geyser and Gumby. At this time, the release of the new AE included a brand-new Installer written by Alloc which could connect to the Mod Depot, offer all mod packages for download, and update the mods and patches already installed. The program [[XmlTools]] was developed by [[User:Script 10k|s10k]] to allow "patch modding" of resources in order to avoid conflicts when different mods attempted to modify the same resource. The AE's bundled content was stripped down to only minimal fixes for the first time, making all notable game modifications into optional third-party mods and ceasing any attempt at centralized game data improvement.

===New content===
Certain game resources were easy enough to reverse-engineer that the community was able to mod them almost from the time of Oni's release, such as textual resources and textures. Some game resources, however, were complex and involved multiple data types, such as character models, and, most obviously, levels themselves. These took a number of years to decipher.

OniSplit first gained the ability to import new character models in April 2008.<ref>See [[User talk:Neo/Archive2]].</ref> At first, since the focus was on the technical side of things, pre-existing models were used, either by modifying Oni's models, or by finding royalty-free models on web sites and converting them to Oni's 19-bone system. A more dramatic use of the character-importing ability came with the creation of a high-detail Konoko model from scratch in October 2010.<ref>[http://oni.bungie.org/forum/viewtopic.php?id=1727 OCF thread, "Konoko HD"].</ref>

A major obstacle with levels was the question of how to generate pathfinding (PF) grids for the AI. Level geometry could be imported fairly easily as of November 2008,<ref>See [[User talk:Neo/Archive5]].</ref> but AIs could not navigate the level. Manual PF grid creation was first demonstrated with the creation of the Arena level in November 2010.<ref>[http://web.archive.org/web/20210117150652/http://oni.bungie.org/forum/viewtopic.php?id=1736 OCF thread, "Arena Level"].</ref> Automatic PF grid generation was introduced to OniSplit around June 2011. More comprehensive demonstrations of the community's level creation abilities came with [[User:EdT|EdT]]'s level "Muro's Lair" in August 2011<ref>[http://web.archive.org/web/20201029113340/http://oni.bungie.org/forum/viewtopic.php?id=2024 OCF thread, "Muro's Lair - Preview"].</ref> and [[User:Samer|Samer]]'s level "Wilderness Preserve" in January 2014.<ref>[http://web.archive.org/web/20211202225410/http://oni.bungie.org/forum/viewtopic.php?id=2698 OCF thread, "NEW LEVEL : Chapter 17: Wilderness Preserve - Hasegawa Adventure"].</ref>

Work continues in all areas of modding Oni, as well as documenting the modding process.
{{clearall}}
==Engine patching==
===Finding Dev Mode===
[[Image:Sfeli Finds Dev Mode.jpg|thumb|225px|right|[[User talk:SFeLi|SFeLi]] documents his discovery in 2006: in examining the binary, he noticed that the list of cheat codes had a gap in it where one cheat had been deactivated – that code was for Developer Mode. For more history, see [[/The tale of Dev Mode|The tale of Dev Mode]].]]
Engine patching is needed when modders want to do things the game's scripts and data do not currently allow for, as well as to fix bugs. Bug fixes were the earliest notable achievement in engine patching, originally performed by a patching application that altered the Windows Oni executable directly, but a revolution in this type of modding occurred in 2006 when [[Developer Mode]] was finally discovered in retail Oni's code, and a means for unlocking it was needed.

The most foolproof method of altering the engine turned out to be replacing a library that Oni loads at runtime. Originally this was done by placing a library next to Oni.exe called vtuneapi.dll, which contained code written by SFeLi that would replace or patch functions in Oni. This library came to be known as the [[Daodan DLL]]. The code for it was ported from assembly language to C by RossyMiles. Eventually the decision was made to instead replace binkw32.dll (the library for playing Oni's intro and outro movies) because it loaded earlier in Oni's launch sequence. The DLL was later developed by Gumby and then Alloc, fixing more bugs (some of which result from modern computers running a {{Age|2001|1|29}}-year-old game), as well as adding new features. The DLL's features and settings are documented on the page for the DLL linked above.

Not long after the Daodan DLL was released for Windows Oni, it was discovered that the Mac versions of Oni still had Dev Mode in them, too. Instead of replacing the Bink Carbon Library that came with Mac Oni, the Omni Group port of the game application to Mac OS X was patched directly with a hex editor. In the fall of 2008, it was discovered that numerous BSL functions and variables that were thought to be removed from Oni for the Mac [[Mac beta 4|before release]] were still present in the code, and the ones which allowed Macs to run (almost) all scripts written for Windows Oni were "unlocked" by EdT using hex edits. Certain changes made by the Daodan DLL for the Windows version were also carried over to the Mac's [[OMNI|PPC game application]] in hex-edit form with Neo's assistance. Later, these changes were made in source for Feral Interactive's [[FERAL|Mac Intel port]].

===Bug fixes===
One of the most visible changes to the game that the Daodan DLL (and equivalent hex edits on the Mac side) made possible came about in July '07 when an error in Oni's AI routines was corrected by Neo, allowing the AI to dodge incoming fire more consistently. Fans had originally been disappointed to see the AI often run blindly into oncoming gunfire. With Neo's patch in place, previously glitched code now works as intended, allowing the AI to dodge projectiles by taking cover.

===Multiplayer===
The most ambitious use of engine patching has been to fill in for Oni's [[Multiplayer|missing multiplayer mode]]. In Windows this was done through the Daodan DLL by the [[Flatline]] project, which saw a rough alpha released in 2010. In Mac OS X, the [[Zukai]] project operated on a Mac equivalent of the Daodan DLL and released a rough alpha in 2015.

===New engine builds===
A new era in Oni's life began with the introduction in 2021 of [[OniX]], a rebuild of the game engine. It remains to be seen how far this development work will take Oni, but in theory the possibilities are almost endless.

----

==Footnotes==
<references/>

[[Category:Community history]]

XML:BINA/TMBD

2025-12-26T06:14:37Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{XML_BINA_Header | prev=SABD | type=TMBD | next=OBJC/CHAR | name=TextureMaterials}}

==General information==
* The XML on this page is based on OniSplit '''v0.9.61.0'''.
* BINADBMTTextureMaterials is a single global resource (level0_Final.dat).
* This file is used to register textures under specific materials which are used for impact effects. See [[XML:BINA/ONIE|ONIE]].
* TMBD contains only textures used by AKEVs (level geometry).
* TMBD cannot contain any decals (textures which are glued onto the wall or ground).
* TMBD cannot contain any textures used by characters. The Striker's armor piece was [http://web.archive.org/web/20160225093442/http://oni.bungie.org/forum/viewtopic.php?pid=27093#p27093 just a test] by Bungie West. See [[XML:ONCC#CBPM:_Character_Body_Part_Materials|CBPM]] if you want to mod materials used by characters.
* Be careful when editing links, as they are case-sensitive.

==XML structure==
<?xml version="1.0" encoding="utf-8"?>
<Oni>
<TextureMaterials>
[...]
</TextureMaterials>
</Oni>

'''''[...]''''' means at least one material with at least one texture. Paste all your data into there.

==Example==
<Material Name="Cloth">
<Texture>covcrate_4</Texture>
<Texture>DL_LAV_FABRIC</Texture>
<Texture>covcrate_1</Texture>
<Texture>covcrate_3</Texture>
<Texture>covcrate_2</Texture>
<Texture>_door_dr_03</Texture>
<Texture>_door_dr_01</Texture>
<Texture>TEST_CLOTH</Texture>
</Material>
Notes: DL_LAV_FABRIC is actually the only texture that is used by "Cloth".

{{XML}}

Casey

2025-12-26T06:14:29Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

[[Image:Intro_frame_0562.png|right|256px]]
[[Image:Act_1_.MISSION_FAILED.png|right|320px]]
[[Image:Act_2_.MISSION_FAILED.png|right|320px]]
'''Casey''' is the name given by the fandom to the enigmatic red-haired man who appears in the intro movie and on the fail screens of Act 1 and Act 2.
*[[Hardy LeBel]] stated [http://carnage.bungie.org/oniforum/oni.forum.pl?read=19649 on the Oni Central Forum] that he might have been a love interest of [[Konoko]]'s in the early story that had been written before he came onboard.
*Fans have also speculated that he could be [[Griffin]]'s son, an idea that was developed in the [[Joint Story]] written on the forum.
*Another suggestion is that he is [[Karen]]'s brother, but has no relation to Commander Terrance Griffin.
*The first name "Casey" was first suggested by Seventeen Seconds (in the context of an graphic novel project). While discussing this character with [[User:Loser|Loser]], [[User:geyser|geyser]] came up with the family name "Shanahan". The idea was that he is of Irish descent (unlike Griffin).

;Playable character
*The first model for this character was created by Loser and geyser. It wasn't as sophisticated as Samer's mod. [http://geyser.oni2.net/pics/screenshots/KONOKOandRED.jpg Here] is an early screenshot.

*Casey was made into a playable character by [[User:Samer|Samer]], and was given various outfits, new moves with vocals, and his own fly-in portrait. The mod can be discussed [http://web.archive.org/web/20160225025731/http://oni.bungie.org/forum/viewtopic.php?id=1262 here].
[[Image:Casey_v6_5_outfits_1.png|600px]]
[[Image:Casey_v6_5_outfits_2.png|600px]]
[[Image:Casey_V6_Glow_Portrait.png|600px]]

[[Category:Characters]][[Category:Modding projects]]

Kojiro

2025-12-26T06:14:21Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

__NOTOC__
[[Image:Commguy.jpg|left|150px]]
[[Image:Comguy Render 1.jpg|right|80px]]
'''Kojiro''' is the unofficial name applied by fans to a [[Comm Trooper|Communications Trooper]] associated with [[Muro]] in the first half of Oni (apparently his right-hand man). It can be implied from the dialogue that he is a confident marksman and/or fighter, as well as a highly skilled hacker and communications expert. The fact that he co-leads the raid on [[TCTF HQ]] would make him at least a peer of [[Barabas]].

Despite his importance, he is never named in Oni material, and is merely identified as "Syndicate Henchman" in the subtitles. Coined by Andrashi a.k.a. [[User:Loser|Loser]], the name "Kojiro" was first used in Loser's Warehouse Mod.

==Identification==
Kojiro is commonly identified as "the Comguy with the goggles", i.e. [[ONCC|ONCCcomguy_2]], although this isn't consistent:
*There are several instances of ONCCcomguy_2 that [[Konoko]] can confront and kill, i.e. regular "Comguys with goggles" (without tabi boots, though).
*Sometimes Muro's Comguy doesn't wear goggles, e.g., at the [[ACC|Atmospheric Conversion Center]].

==In-game appearances==
{|align=right
|-
|[[Image:Comm Trooper 2.gif]] [[Image:Comm Trooper 1.gif]]
|}
*In {{C|3}}'s outro (unseen), offering to kill Konoko as Muro's van drives away: "[[Quotes/Speech#Outro_3|Should I take her out?]]"
*In {{C|5}}'s outro (as ONCCcomguy_2), [[Quotes/Speech#Outro_4|talking to Muro]] about how he's been monitoring Konoko during the chase.
*In {{C|6}} (as ONCCcomguy_2), taking part in the raid on TCTF HQ: "[[Quotes/Speech#Syndicate.27s_progress|All units converge.]]"
*In {{C|7}} (as ONCCcomguy_1), standing by Muro's side as Shinatama is being tortured.
*In {{C|8}} (as ONCCcomguy_1), following Muro on his way out of the Atmospheric Conversion Center.
We are not listing appearances of generic goggled Comguys (some of them randomized) or obsolete cutscene material from {{C|4}}.

==Related mods==
===Loser's Warehouse===
Loser's Warehouse is a high-difficulty version of {{C|1}}, with many unexpected challenges (like having to activate the forklift without using the stairs). The boss fight against Kojiro appears at the end of the mod and constitutes one of Loser's first attempts at realistically unforgiving AI. Before the fight, Kojiro introduces himself both by name and as [[Mukade]]'s apprentice. Inspired by the [[Oni2:Truth Number Zero|Truth Number Zero]] hypothesis (or was it the other way around?), Loser's Kojiro fights with [[Ninja]] moves and is able to teleport. At the end of the fight, he says that the only goal of the (very challenging) fight was to hold Konoko back, allowing either for Muro's preparation of the Musashi/Vago operation, or for some other unspecified initiative (Mukade's?).

===Samer's character===
;Playable version
:Kojiro was made into a custom playable character by [[User:Samer|Samer]] and also made part of the [[Saisei Team]]. Mod available [http://web.archive.org/web/20160224195230/http://oni.bungie.org/forum/viewtopic.php?id=1282 HERE].
;NPC and opponent
:The SamMegaPack Conversion mod uses the new Kojiro model in the canonical appearances listed above and in a bonus appearance during the final battle as an additional opponent. The SamMegaPack Conversion is available [http://oni.bungie.org/forum/viewtopic.php?id=2467 HERE].

[[Image:Kojiro-mod.jpg|1000px]]

[[Category:Characters]][[Category:Syndicate]][[Category:Modding projects]]

Restless Souls/Summary

2025-12-26T06:14:11Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{Template:RestlessSouls}}

=Entities=
Some name are more or less place holder names'''(*)'''. Any suggestion is welcome.

==BGI==
BGI is a [[wp:Concern (business)|(business) concern]] which originated from WCG's installation. As a consequence to the overall shrinking military-industrial complex, the leading companies united instead of fighting each other. They absorbed the best ex-military, research and production sites to become a monopoly making it easier to formulate profitable conditions against WCG in business contracts. Their expertise and power is a guaranty that WGC signs most contracts with them. BGI became the primary vendor for TCTF and any remaining special military. BGI offers just everything: beginning from TCTF auto-pistols and ammunition up to aircraft carriers and military support units to help beat down sudden, regional riots. The WCG is no longer interested in maintaining a military that used to have [https://www.cfr.org/backgrounder/demographics-us-military millions jobs around the world.]

As war and conflict is their business model BGI established shady ties to the Syndicate whose actions guarantee a steady demand for weapons within the supposed to be de-militarized and unified world. By now BGI is as corrupt as the very Syndicate some TCTF investigators even don't differentiate anymore between them. This latest development is still to be proofed. WCG's support for BGI makes it difficult for the TCTF to investigate directly against BGI - all the more since the TCTF is depending on BGI's capacities to fight known Syndicate branches.

BGI is interested in status quo. Muro's rise to power is a thorn in their eyes. Since Muro started to become independent from BGI they are planing to get rid of Muro. In latest past they build up an anti-Daodan task force which includes heavy mech Iron Demon.

===Encounter with Mai in Hasegawa's lab===
Mai knows the location because either at this place they took her DNA samples for the prototype - or because of the disc.

As for the TCTF Hasegawa's lab is "old, useless and forgotten" = not on their mind anymore. However the alarm still exists.

BGI has WCG' "carte blanche" (full freedom/permission) to react on high level threats and hence receives TCTF alarms as well.

BGI wants a stealth attack on Mai and therefore declares the alarm as code black (top secret, silencing it) before it has a chance to bubble up through all other TCTF offices. (In the name of national/WCG's security explanation are given at a later time.) The reason for not being presented at Griffin's screen immediately is that with time that alarm was given lower priority because of more probable vandalism. But BGI's Daodan task force is actively looking for such signals as Muro is more and more pissing them off. By now they know he has sister - another threat.

This goes hand in hand with Iritscen's text: "After Chapter 8, Konoko is declared "rogue" and BGI sees that she is becoming yet another out-of-control Daodan host, so they begin to make moves against her."

Dream lab happens.

==Biocracy==
The idea of a Biocracy [[wp:Convergent_evolution|evolved independently]] [https://wiki.oni2.net/w/index.php?title=Restless_Souls/Summary&diff=16517&oldid=15418 around 2010] and has nothing to do with the works of [[wp:de:Georg_Winter_(Manager)|Georg Winter]] or anyone else.

Biokratie fußt nicht auf den Ideen des Transhumanismus und des Posthumanismus. Es sollen normale Menschen mit einem demokratischen System auch für längere Zeit überleben können. Daher waren Nachhaltigkeit, planetare Grenzen (im engeren Sinne, 2017er Modell) und um zukunftssicher zu sein, die Evolution aller beteiligter Systeme von Interesse. Obwohl Biokratie auch weit in die Zukunft planen kann, stellt es zukünftige (ungeborene) Generationen nicht über ihre akutellen Bürger, wie in einer [[wp:Longtermism|Longtermism]]-Ideologie. Biokratie an sich beantwortet keine ethischen Fragen. Das müssen die Bürger untereinander selbst ausdiskutieren.

Biokratie ist ein geringfügig mehrdeutiger Begriff.

* In erster Linie ist Biokratie eine Daten gestützte '''politische Herrschaftsform''' und damit eine Weiterentwicklung von Demokratie. Bio für Ganzheit des Lebens and Kratos für Herrschaft. Um langfristig zu überleben, muss der '''Mensch lernen planetare Grenzen zu berücksichtigen'''. Ganz konkret macht zum Beispiel die Verbundenheit aller Systeme einen [[wp:de:One Health|One Health]]-Ansatz zur Verhinderung von Seuchen und Antibiotikaresistenzen notwendig. '''Neue menschliche Auswirkungen auf die Natur müssen wortwörtlich mit einkalkuliert werden.''' Vermenschlicht und verknappt ausgedrückt, hat die Natur ein Wörtchen mitzureden. Es sollte eine politische Quasi-Mitbestimmung geben. Biokratie: Herrschaft (durch die zumindest Berücksichtigung) aller Lebensformen. Da das aus allerlei Gründen natürlich nicht möglich ist, muss der Mensch selbst stärker im Sinne der Natur handeln, sie vertreten, auch wenn er die '''Win-Win-Situationen''' in Wahrheit nur '''aus eigenem Interesse''' anstrebt.
** Um die angestrebten Verbesserungen stemmen zu können, braucht es neue Werkzeuge: Sensoren-Netzwerke, Datentransport-Infrastruktur, verarbeitende Computerkapazitäten, die Software sinnvolle Auswertungen vorzunehmen und komplexe Ist-Zustände in Simulationen leicht zugänglich präsentieren zu können. Erst später sollen auch menschliche Eingriffe (Soll-Zustände) vor ihrer realen Umsetzung dort getestet werden: Weil Biokratie ist sich auch seiner eigenen Grenzen bewusst. -- Da alle planetare Grenzen, Auswirkungen neuem menschlichen Handelns und die Gesamtheit des Lebens im Blick gehalten werden soll, braucht es eine AI. Ihre Mächtigkeit und ihre Aufgabengebiete legen nahe sie Gaia zu nennen.
** Für das spielerische Lernen durch neue Generationen und die versinnbildlichte politische Mitbestimmung (symbolische Repräsentation) sind simulierte Spezies-Avatare angedacht. Die Dekodierung tierischer und pflanzlicher Kommunikationsmethoden hat damit nichts zu tun und dient lediglich dem weiterem Erkenntnisgewinn.
* Es ist schwierig das nicht irgendwie ein Wortspiel zu nennen, aber im übertragenem Sinne soll Biokratie auch eine "lebendige Herrschaftsform" sein - stärkere Mitbestimmung durch Bürger bieten - und sich gleichzeitig ähnlich einem lebenden System verhalten: Um wirklich effektiv - global - zu wirken, muss Biokratie wachsen, aktiv lernen, sich selbst verbessern.

===Das Internet als Problem===
[In-story monolog of '''history'''? A text from a school lesson? Hanna/Controller?]

'''Die vernebelte, hyperkomplexe Welt'''

Daten und Erkenntnisse nahmen immer weiter zu.

Es herrschte ein Angebotsüberfluss bei gleichzeitig fehlender Qualitätssicherung.

Faktenchecker existierten zwar, treten aber zu selten in Erscheinung.

Jeder konnte sich die Information herauspicken, die zu seinem Weltbild passten.

"Die Spaltung der Gesellschaft" war ein harmlos klingendes Fossil der Vor-Internet-Zeit.

Es bildeten sich immer kleiner werdende hyperpersonalisierte Communities in Informationsblasen. Empfehlungsalgorithmen und Selbstbestätigung verfestigten die Positionen. Jede Gruppe beanspruchte die Wahrheit für sich.

Diskussionen litten ebenso an fehlender Langsamkeit und künstlicher Emotionalisierung. Empörungswellen, Shitstorms, Cancel Culture.

Hinzu kamen immer leichter werdende Manipulationen. Digitaler Lobbyismus, Desinformation, Fake News, Deep Fakes.

Doch das Problem war nicht nur digital. Auch die Komplexität von Hightech- und Software-Produkten nahm zu. Dementsprechend wuchs berufliche Spezialisierung und die Tendenz der gegenseitigen Wahrnehmung als Fachidioten.

So spaltete der scheinbar immer schneller werdende technische Fortschritt auch insgesamt über Konsumverhalten, Interessen, Bildung, Beruf und Alter.

Die Menschen verloren die Übersicht und das Verständnis füreinander.

Das Misstrauen wuchs.

Privatwirtschaftliche Medien, der sensationsjagende Boulevard nicht der Rede wert, standen unter Verdacht zu sehr aufs Geld zu schauen. Aufgebauschte oder gekaufte Stories. Clickbait mit Thumbnails und Headlines. Es war die Zeit eines neuen Strukturwandels mit zusätzlichen Konkurrenzdruck von Influencern und Bloggern. Mit Print war zunächst immer weniger Geld zu machen. Das Internet lockte mit kostenlosen Inhalten. Seit Jahren versuchte der Qualitätsjournalismus für sich zu werben und Abo-Modelle anzubieten. Zusammen mit den
staatlichen Medien, dem öffentlich rechtlichen Rundfunk (ÖRR), standen sie unter Verdacht Schönfärberei für die Regierung zu betreiben. "Lügenpresse."
{| class="wikitable" width="200" style="float:right; margin-left: 20px;"
|
{{divhide|ÖRR}}
Eigentlich sollte es um gesicherte Information gehen. Doch werden auch Unterhaltungsprogramme angeboten, die die Kritik an GEZ-Zwangsabgaben noch lauter werden lässt. Hat man das Recht auf Nicht-Informiertheit? Der Staat ist in der Pflicht den Bürger mit dem Notwendigsten an Infrastruktur zu versorgen. [[wp:de:Infrastruktur#Arten_der_öffentlichen_Infrastruktur|Verwaltung, Bildung, Arbeitslosenversicherung, Rente, Wasser, Medizin, Straßen, Landesverteidigung und vieles mehr.]] Man braucht nicht alles davon zu jeder Sekunde seines Lebens, doch ist es schon ziemlich substanziell. Wenn man den ÖRR als Teil der Informationsinfrastruktur ansieht, der den Bürger mit dem Notwendigsten an weitgehend neutraler, gesicherter, lokal bis global bezogener Information versorgt - wie es ein einzelner privatwirtschaftliche Akteur vielleicht niemals könnte, hat er durchaus seine Daseinsberechtigung. Zudem wird seine Bedeutung als Faktenchecker im Zeitalter der Desinformation zunehmen.

Unterhaltungsangebot: Grundsicherung oder "Luxus" und Kompetenzüberschreitung?

[...]
{{divhide|end}}
|}

Währenddessen bot das Internet auch noch der falschesten Information die Möglichkeit gelikt und geteilt zu werden.

Das Internet wurde zu Freund und Feind von Freiheit und Pluralismus. Demokratien schienen auf dieses Problem nicht vorbereitet.

Information kann Menschen zusammenbringen. Doch zu viel und ungesicherte Informationen überfordert und spaltet sie.

'''Wer hat die Übersicht, die Kompetenz, die Performance und die Neutralität, um uns als Gesellschaft wieder zu vereinen?'''

[...]

Food for thought:

* Entfremdung der Bürger von den Politikern
* Entfremdung der Politiker von den Bürgern
* Biokratische Lern- und Arbeitsgruppen (Seed Groups) als Weiterentwicklung der Bürgerräte?
* Die unkontrollierte [[wp:de:Ökonomie_der_Aufmerksamkeit#Kritik|Aufmerksamkeitsökonomie]] führt zu einer Fragmentierung, letztlich Spaltung, der Gesellschaft. Verstärkt wird dies durch politische Konkurrenz, von innerhalb und außerhalb einer Nation. Wettbewerb zwischen Ideologien und Systemen. Das Internet wurde/wird aktiv genutzt, um Wahlen zu beeinflussen. (Meinungsbildung via Facebook (z.B. Cambridge Analytica), Streuen von Desinformation, Wahlen in Indien (Whatsapp-Gruppen für Stigmatisierung und Mobilisierung verschiedener Wählerschichten))

===Das Internet als Lösung===
Das Internet mit seiner Netzwerkstruktur und Geschwindigkeit hat die Möglichkeit die Performance und Überlebensfähigkeit jeder Staatsform zu steigern. Durch den Wettbewerb der Systeme ist es somit selbsterklärend warum auch Demokratien von den Vorteilen des Internets und neuer Informationstechnologien profitieren sollten.

Doch wie soll das im Detail aussehen?

===Systemkritiken===
Verbesserungen lassen sich immer am Besten von bestehenden Problemen ableiten. Was sind Probleme bekannter Systeme?

'''Diktatur:'''

* Selbst ein von jeglicher Ideologie befreiter "wohlwollender Diktator" wäre nicht vor Fehlentscheidungen gefeit, da er die Realität in ihrer Gänze nicht wissen kann.

'''Autokratie:'''

* Autokratische Führer, die nach Festigung ihrer Macht streben, neigen zu Cliquenbildung. Sie umgeben sich mit Gleichgesinnten und Jasagern, sodass kritische aber notwendige Argumente Gefahr laufen nicht gehört zu werden. Je weniger kritische Berater involviert sind, desto weniger können Fehlentscheidungen korrigiert werden. Eine Demokratie kann eine Fehlentscheidung oder Fehlbesetzung durch den Machtwechsel von Parteien schneller korrigieren.

'''Demokratie:'''

Herrschaft des Volkes. Souveräne Wähler. Eigentlich.

* '''Eigenes Untergraben von Vertrauen.'''
** Wenn man im erweiterten Sinne nach den wichtigen Kriterien Parlament und Parteienwahlsystem ausgeht, haben sich aus Effizienzgründen ziemlich viele '''[[wp:de:Repräsentative_Demokratie|repräsentative Demokratien]]''' herausgebildet. (Über die [[wp:de:Demokratieindex|Qualität der einzelnen Demokratien]] und ihrer Unterarten soll hier nicht eingegangen werden.) Der Nachteil ist, dass dies Instanzen zwischenschaltet, die wiederum eine Eigendynamik mitbringen: Es werden vorab Wahlgeschenke verteilt oder hinterher Wahlversprechen nicht eingehalten, weil Vertreter und Parteien sich gezwungen sehen Machtpolitik zu betreiben. '''Das sorgt insgesamt für Frust.'''
*** Aufgrund langer Entscheidungsprozesse kann Demokratie auf Krisen manchmal nur schlecht reagieren. Mehr gesplittete Zuständigkeiten, Streit unter Koalitionspartner. Unterschwellige Interessenkonflikte und '''[https://www.tagesschau.de/inland/innenpolitik/habeck-union-wachstumschancengesetz-100.html Machtkämpfe]'''. Strategien müssen oft mit kürzeren Zeiträumen auskommen, da sich Machtverhältnisse und Personalien schneller ändern. In Nicht-Krisenzeit wird oft "von Meckern auf hohem Niveau" gesprochen. Der ständige Modus von Versuch und Irrtum kann Demokratien sowohl fördern als auch lähmen.
** Ungeeignete Politiker werden von ihren Parteien sehr lange gestützt, weil die Parteien sonst eigene Fehler eingestehen müssen und der politische Gegner damit Stimmung machen kann. Machtverlust.
* '''Äußeres Untergraben von Vertrauen:'''
** Die Beeinflussung durch Großspenden und der Dauerbeschuss von Lobbygruppen ist ein altbekanntes Problem. Dies stößt beim einfachen Wähler besonders bitter auf, weil er sich nur schwer dagegen wehren kann. Parteien tun sich schwer die Situation zu verbessern und für Transparenz zu sorgen. Beratungen sollten nur von der Politik selbst angefordert werden können.
** Korruption
* Direktdemokratiesche Modelle kranken an dem fehlenden Expertentum durch die teilnehmenden Wähler. (Argument der dummen Masse.)


Kritik an Kommunismus und Kapitalismus: [...] Das böse Wort mit K...

Kritik an Planwirtschaft und Marktwirtschaft: [...]

* Marktwirtschaft kommt letztendlich nicht ohne begrenzende Regeln aus. (Monopolbildung, Kartelle, Preisabsprachen)
* Planwirtschaft scheitert an der Wirklichkeit. (...) Der Staat kann nicht alles vorgeben. Es kommt zu Fehlplanungen. Negative Entwicklungen werden schlechter korrigiert.

[Biokratie: Ganzheitlich gedachtes System für Politik und Wirtschaft]

'''Biokratie:'''

* Die technischen Hürden für Biokratie sind immens.
** Datengenerierung.
** Übertragung per Quanteninternet.
** Komplexe Simulationen bedingen ausgereifte AIs und Quantencomputer.
*** Das macht Biokratie vor etwa 2060 zu kostspielig und - durch das Inzweifelziehen wie lebensnah so ein System sein kann - leicht angreifbar. Der tatsächliche Einsatz dürfte sich bis 2080 verzögern. Notwendige Investitionen für den Aufbau der Infrastruktur werden vermutlich durch die Zunahme durch Umweltkrisen verzögert. Jedes Nennen eines früheren Datums würde nur falsche Hoffnungen, Enttäuschung und Ablehnung schaffen. -- [https://www.faz.net/aktuell/politik/inland/gedenken-an-1848-wie-steht-es-um-die-zukunft-der-demokratie-18896663.html Manche träumen von einer Vollendung der Demokratie. Andere weisen darauf hin, dass Demokratie nie fertig sein kann und dass, das nicht schlimm sei. Mit Biokratie ist es ähnlich: sie bassiert maßgeblich auf Fortschritt, ergo Evolution. Eine Revolution - eine kurzfristige, womögliche gewaltvolle Umwälzung - entspricht überhaupt nicht ihrem Charakter.] Es werden auch keine "Vorkämpfer" oder "Vordenker" gebraucht. Biokratie ist vielmehr ein demokratisches System-Upgrade, welches sich Patch um Patch selbst installiert. Die Weiterentwicklung von Demokratie hin zur Biokratie ist ein Automatismus, der vorgezeichnet ist durch kontinuierliche Verbesserungen aus technologischen Erfindungen. Wie der Demokratie ist auch der Biokratie der Anspruch fremd perfekt zu sein. Aber stattdessen ist sie darauf ausgelegt selbst immer besser und besser zu werden. Obwohl diese Entwicklung automatisch passieren würde, wäre es klug diese Entwicklung etwas zu beschleunigen. Denn in der zweiten Hälfte dieses Jahrhunderts werden technologiegetriebene Autokratien und die alten Demokratien in einer aggressiven bis gefährlichen Rivalität stehen.
*** Neben der Rechenpower ist auch die innere Qualität von Simulation und AI essentiell: Der größte Trugschluss wäre, dass man Simulationen nur mit genügend Daten füttern muss, damit neue Erkenntnisse gewonnen werden können. -- Im Allgemeinem ist eine Simulation immer ein Nachbau eines Teils der Wirklichkeit mit begrenzter Quantität an Daten. Damit trotz dieser gleich zweifachen Begrenzung sinnvolle Ergebnisse zurückgegeben werden, müssen die Eingabe- und Ausgabeparameter sowie das rechnende Modell so definiert sein, das sie selbst eine hohe Qualität aufweisen. Die Simulation mit nur immer mehr und verschiedenen Daten füttern, macht sie daher nicht automatisch besser: es kann die Qualität sogar senken, die gewünschten Ergebnisse verwässern. Eingabeparameter und Funktionen müssen stets über die richtige Gewichtung verfügen. Mit der Zunahme der Komplexität - der Inputparameter und damit des rechnenden Modells - steigt naturgemäß auch die Schwierigkeit gute Simulationen zu erstellen.
**** Vermeidung einer Blauäugigkeit gegenüber Technik: Egal wie gut und schnell Simulationen und AI scheinbar arbeiten werden. Die Wirklichkeit wird immer zu komplex sein und vom erwarteten Ergebnis etwas abweichen. Je weiter irgendetwas in die Zukunft prognostiziert wird, desto größer werden die Diskrepanzen.
**** Simulationen generieren kein Wissen, dass nicht ohnehin schon in den Daten steckt. AIs können zwar dabei helfen, sind aber letztendlich wie Simulationen and die Wirklichkeit gebunden: Deep Learning, neural nets, machine learning, artificial intelligence sind gewissermaßen die jeweils höheren Erweiterungen von Simulationen und benötigen somit ebenfalls eine Qualitätssicherung für Daten und Modell. (...) Die virtuelle Wirklichkeit in den AIs, die Modelle, sollen möglichst selbst durch Mustererkennung erlernt werden. (...) Die Fehlertoleranz in arbeitenden und lernenden Modellen ist nur begrenzt möglich. Zur wahrhaften Selbstverbesserung von Modellen benötigt die AI Selbstbewusstsein, in dem Sinne, dass sie Kenntnis über ihre eigenen Aufbau hat. Der notwendige Grad an Komplexität zeigt auch die Ironie dieser Entwicklung: um eine echte AI zu bauen, benötigt man geradezu eine AI. Die doppelte Ironie der Entwicklung ist, dass es am Ende doch das Zusammenbringen von genügend Teilen ist: von genügend unterschiedlichen, spezialisierten Subsystem die per Emergenz, die eigentliche AI darstellen. Aber erst ganz zum Schluss. -- Es wird inkrementelle Verbesserungen geben. Es wird neue Möglichkeiten und Hypes durch Paradigmenwechsel geben. Aber zu einer echten (Menschen ebenbürtigen) AGI ist es noch ein weiter Weg.
* Fehlende Akzeptanz. Das politische Systemupgrade kann nur schrittweise erfolgen.









===Wirtschaft und Politik einheitlich denken===
[[Image:route_of_technology-driven_development.jpg|thumb|right|200px|QC and AI as most important driver of technological and biocratic development]]
"Chaotische" Systeme wie Wetter und Klima sind nicht gänzlich unberechenbar, sie sind aber dermaßen hochkomplex, dass ihre Simulationen immer nur begrenzte Prognosen zulassen.

Mit der Zeit werden nicht nur Klimamodelle immer besser, es entstehen auch ganz neue Möglichkeiten. Dem technischen Fortschritt sei Dank.

* Die Rechenpower steigt immer weiter.
** Das betrifft insbesondere das Quantum Computing. (Das Mooresches Gesetz ist tot. Lang lebe das [[wp:Hartmut Neven#Neven's law|Nevensche Gesetz]].) '''AI und QC werden sich gegenseitig optimieren helfen und die wichtigsten Schlüsseltechnologien (Enabler) menschlichen Fortschritts und Wohlstands darstellen.''' Sie haben das Potential Forschung in jeder [[wp:de:Exakte Wissenschaft|harten Wissenschaft]] direkt oder indirekt zu beschleunigen.
** Standardprobleme können durch spintronische CPUs energieeffizienter gelöst werden.
** Spezialprobleme können durch memristische und photonische Prozessoren energieeffizienter gelöst werden.
* Daten können durch das Quanteninternet - also auf Basis von Lichtteilchen - mit Hyperentanglement viel effizienter verschickt werden - und das bei höherer Sicherheit.
* Die Sensordichte und damit auch die Datenmengen steigen immer weiter an.
** '''Smart Cities''', Smart Villages, Smart Homes, Computervision in Autos, IoT.
** '''Vierte industrielle Revolution''' (Industrie 4.0, Industrie 5.0), '''[[wp:de:Smart Farming|Smart Farming]]'''
** '''[[wp:Hyperspectral_imaging|Hyperspektrale Aufzeichnungen]]''' durch Satelliten.

Die zukünftige Welt wird soweit quantifizierbar und modellierbar, dass ganze Gesellschaften simuliert werden können.

Wie kann uns das nützen? Eine beliebte Frage in der Politik, besonders in der Opposition, ist: "Wie wird das finanziert?" Wenn man schon nicht an der Macht ist, versucht man zumindest, auf echte oder vermeintliche Fehler hinzuweisen. Dieser Streit ist an sich gut, frisst aber auch viel Zeit. Andererseits sind Interessen oft genug ideologisch - oder eine Gruppe versucht sich schlicht auf Kosten einer anderen Gruppe zu bereichern.

Ideologie ist oftmals gar nicht böswillig sondern eine Krücke: Da wo keine Fakten vorliegen, muss man eben hoffen (glauben), dass es funktioniert.

Was nützt es eine Demokratie zu haben, wenn ihre Mitglieder oft nicht die Informationen haben, vernünftige Entscheidungen zu treffen?

Biokratie soll durch das Ansammeln, Auswerten, Bereitstellen und wiederum Weiterverarbeiten von Informationen jegliche Form von Ideologie reduzieren helfen. Monitoring und Fehlerkorrektur inklusive.

Grundlage aller Entscheidungen sollte es sein ein möglichst genauen Ist-Zustand von Umwelt, Wirtschaft und Gesellschaft zu kennen.

Je genauer die Kenntnis über die Ist-Zustände (einschließlich der planetaren und nationalen [[wp:de:Planetare_Grenzen|Grenzen]]), desto genauer, effizienter und risikofreier können die Soll-Zustände erreicht werden. Alle politische Parteien werden über die Biokratie auf den gleichen Kenntnisstand gebracht und müssen dann nur noch über die Priorisierung der Ziele streiten. Demagogen und radikale Populisten können durch Faktenchecks in Echtzeit ausgebremst werden.

Welche Ressourcen stehen zur Verfügung? Welche Investitionen in die Infrastruktur sollten Priorität haben? Was soll in Pattsituationen passieren? Welche gesellschaftlichen Kurskorrekturen müssen des Weiteren vorgenommen werden?

===Wettbewerb der Systeme===
China ist heute schon führend im [https://web.archive.org/web/20220603080446/https://www.tagesschau.de/wirtschaft/technologie/patente-technologie-china-usa-101.html Anmelden von Digitalpatenten]. Der Datenschutz und die individuellen Rechte sind der nationalen Entwicklung untergeordnet. So werden Prozesse in Bürokratie, im Rechtswesen, im Gesundheitssektor und in jedem Wirtschaftssektor gleich zweifach beschleunigt. Dementsprechend wird China innerhalb des westlichen Selbstverständnis nicht das bessere System sein, aber das effizientere. Das wird zwangsläufig zu Entwicklungen führen, um irgendwie wieder on par zu werden. Die durchdigitalisierte chinesische Autokratie wird als Systemkonkurrent der europäischen Biokratie unbeabsichtigt auf die Sprünge helfen. Man will ja nicht für immer abgehängt werden.

===China: early adopter of simulations as political tool===
In the second half of the 21th century the world was "sufficiently" digital. Even the Taliban in Afghanistan - a country once laughed about being cave man terrorist territory - had instant messengers and social media to communicate and spread their narratives. The poor, the rich. The school children, the seniors. By now everybody had mobile phones. Everybody had an account connected to the internet. And when you were dead your facebook account were simply "memorialized".

Even when you did not had a social media account. By using mobile phone the corporations were tracking all your steps. All your walked steps. The vaccination status, sleep periods, nutrition, shopping, leisure activities, reading behavior and consumed news feed and therefore your political liking. Intelligences had access to those information otherwise used by the corporations for ad placement, recommendation and profit maximization. AI supported surveillance and social credit system completed the profile. You had a file whether you wanted or not.

[Echo from the manual] ''Big Brother was well and alive.'' People had become made out of glass.

Inspired by past conflicts and catastrophes the Chinese were first to use all those information for sophisticated QC-based simulations. Over the years they grew from state level to regional and eventually to global scales. The simulations are meant as a rough decision instrument, as a reinsurance that no crucial information or development is overlooked in politics or economy in times of crisis. - Evil tongues argued it was also to warn them against own ideological missteps.

[This could serve as a natural hook to a Biocracy within a Chinese perspective. The existing tools - the simulations - could be another door for Pensatore to reach Feng.]

----
Weitere Notizen:

QC Simulationen fügen sich existierenden Trends in China und USA an.
* Digitale Massenüberwachung (unter Anderem [https://archive.ph/uJ4Nk durch] [[wp:Evercookie|Evercookie]]
* Verbrechensvorhersage ([http://web.archive.org/web/20220702045125/https://www.nytimes.com/2022/06/25/technology/china-surveillance-police.html Predictive Policing])

----

Pandemieprognosen

Kriegsprognosen

Wirtschaftsprognosen.
: ''Warum Zukunft vorhersagen müssen, wenn man sie gestalten kann?'' Für die Chinesen dürften Simulationen besonders interessant sein, streben sie doch eigentlich nach Kontrolle - im Sinne einer gelenkten statt einer sich selbst organisierender Wirtschaft. Selbst innerhalb des Staatskapitalismus mussten die großen Tech-Unternehmen nachträglich reguliert werden. Mit mächtigeren Werkzeugen könnten sie versucht sein eine Planwirtschaft 2.0 einzuführen. Mit zunehmenden Daten und der Möglichkeit diese zu verarbeiten, gibt es keinen Grund nicht anzunehmen, warum China die erste Nation sein wird, die Simulationen nutzen wird, um Entscheidungen für jeden Aspekt des Lebens zu treffen.

Es ist davon auszugehen, dass nach China erst die USA und dann auch Europa Simulationen Teil ihres Instrumentenkastens machen wird.

Liberale Gesellschaften sollten daran arbeiten, diese mächtigen Werkzeuge verantwortungsvoll einzusetzen und nicht von ihnen korrumpiert zu werden. Effizienz ist höchst erstrebenswert aber kein Selbstzweck.

===Nationale AI als Vertrauensperson des Bürger===
Eine nationale AI hat die Möglichkeit als unbestechliche, neutrale und damit höchst vertrauenswürdige Entität aufzutreten.

Anfragen bleiben nicht länger in der nicht-digitalisierten Bürokratie stecken und werden sofort bearbeitet.

Verlorenes Vertrauen in den Staat kann wiederhergestellt werden.

Hoffentlich wird [[wp:GPT-3|GPT]]-7 bereits soweit multimodal und ausgereift sein, dass man damit langsam anfangen kann, solche AIs zu kreieren.

===Biokratie als wirkliche Mitmachdemokratie===
Aktive Bürger
Die demokratische Grundidee von "jede Stimme zählt" wird um "jedes Argument zählt" erweitert. Was früher aus Effizienzgründen nicht möglich war, kann nun mit Hilfe der AI realisiert werden.
...

In einer realistischen Umsetzung wäre das Wort Biokratie ein denkbar schlechter Name für eine Weiterentwicklung von Demokratie, wenn man grünenfeindliche Wirtschaftsliberale, Konservative und Ultrakonservative davon überzeugen will. Allein das Wort "Bio" wird sie triggern und populistische Verhinderungsangriffe fahren lassen. Man müsste '''Information in den Fokus rücken'''. Ihre Themen sind Wirtschaftsliberalismus, der freie Markt, kaufmännische Überlegungen. Von daher: Bessere Informationen bringen bessere Entscheidungen bei Investitionen, besseres Management und mehr Vorteile im Wettbewerb. Letztlich bietet mehr Information mehr Selbstbestimmung (-> Liberale), Freiheit (-> Liberale/Progressive) und Macht (-> Sicherheit (Verteidigung), Kontrolle für Konservativen). Information: Grundlage von rationalen Denken, Innovation, Fortschritt. (Die Epoche der ''europäischen'' Aufklärung lässt grüßen.) '''Abbau jeglicher Ideologie''', die als Krücke des es Nicht-besser-Wissen diente. Und je effizienter eine Gesellschaft und Volkswirtschaft arbeitet, desto mehr kann umverteilt werden. (-> Sozialdemokraten)
Alle profitieren.

===Schrittweise Weiterentwicklung von Demokratie===
Föderale Demokratie (Deutschland) sowie zentralistische Demokratie (Frankreich) haben beide ihre Stärken und Schwächen. Ein adaptiver Föderalismus oder adaptiver Zentralismus - zwei Bezeichnungen, die hier die gleiche Mischform meinen - könnte die Demokratie ein wenig effizienter machen. Ideen die beispielsweise in einer Krise neu entwickelt werden müssen, beginnen föderal und die besten werden schließlich zentralistisch umgesetzt (sofern auf andere Regionen übertragbar).

Damit die Spitzenpolitiker auch sonst ein Ohr am Volk behalten, sind Bürgerräte theoretisch eine gute Ergänzung. Praktisch finden sie wenig Gehör. Verbindlicher machen?

[...]

Dörfer freier entscheiden lassen? "Sie wissen am besten was sie brauchen."

[...]

-> Lern und Arbeitsgruppen. Vernetzung fördern. Expertenwissen bereitstellen

-> Infrastruktur für Biokratie schaffen und allen zur Verfügung stellen

[...]

Smart cities.

Nationale Biokratie.

Globale Biokratie: durch Versöhnung der Systeme? Wie lässt sich das vereinbaren? ("Korpsgeist" stärken. Neue Technologien werden gemeinsam entwickelt und die Implementierung gefeiert? Einerseits durch das Zusammenlegen von Computing Ressourcen, und andererseits durch die Nutzung nationaler/kultureller Eigenheiten und einem Wettbewerb, der nicht in neue Feind-/Rivalvorstellungen ausartet? Vielfalt als Möglichkeitenpool.)
* Aktive Mitbestimmung: Westliche Modelle (Wahlen und Bürgerräte?)
* Passive Mitbestimmung: Chinesisches Modell (automatische Datenerhebung?)
* Gemeinsame Leitplanken sind der Schutz und die Förderung von Leben. (Gesundheit, Bildung, Abbau von Armut, soziale Sicherungen, Überleben der Spezies Mensch)

Inwieweit müssen aus pragmatischen Gründen ein paar ideologische Unterschiede vorerst unangetastet bleiben? Wird eine Realpolitik über mehrere Generationen benötigt?

Mehr Wohlstand für alle als Gemeinsames Narrativ? Ein west-östliches Tianxia? Himmel auf Erden? "Paradiesische" Zustände? Individuum und Kollektiv sind in die Natur eingebettet. Insofern müsste es genügend Schnittmengen für ein gemeinschaftliches Handeln geben. Das alles klingt erst einmal hoffnungslos naiv und eignet sich nicht für einfache Tagespolitik. Man müsste es in größere Etappen aufteilen.

Konkurrenz (Wettbewerb) und Kooperation sind Treiber menschlicher Evolution. Wie wird beides in einer globalen Biokratie ausbalanciert?



===Shin's mistake===
Avatara and Gaia created simulations to represent the different species in a Biocracy. This was meant to make sure there was a stronger consciousness for nature, its "needs" and therefore a stronger consciousness for human's long-term foundation of survival.

Unfortunately Shinatama had inherited ideas from Shintoism in which the world and nature was ensouled. (Free the restless souls?)

With the existence of AIs and the meme theory Shinatama easily justified giving nature real avatars so that their influence wouldn't be "virtuell" anymore. She reasoned that bringing the AI to "full life" via avatars would ensured their political participation and prevent AI slavery.

This development was fostered by the "Controllers" to fight Avatara and take over Gaia.

==Bio-Crisis==

===HAPē mask campaign===
[[Image:TXMPPOSTER1.png|thumb|64px|right|Poster #1]] [[Image:TXMPPOSTER3.png|thumb|64px|right|Poster #2]]
Word pun of HAP and erroneous pronunciation of "ē" for "y". "Happy mask". See poster #1.

Note: if we wanted to keep this "intentional erroneous" pronunciation: this also works in German-speaking areas by saying "Ha-Pe" mask (in English just "HP"). "Wear your mask, keep your health points..."

The campaign was especially meant '''to motivate children to use their HAP masks''' so they would not inhale toxic air.

Related terms:
* National Emissions Standards for '''Hazardous Air Pollutants'''
* Dioxin (Sturmanderung console page), Polychlorinated dibenzodioxins, Agent Orange, toxic air
* Fight against WCG's artificial mycorrhiza, Biocrisis

==Black Season==
Time right after the [[12/3|cataclysm]]. Marked by chaos and death.

Due to the tendency to build ACCs only in range of large cities and the rushed activation of the Sturmanderung pulse, the destruction probably isn't as widespread as Konoko says.

{| class="wikitable" width="100%"
|
[http://web.archive.org/web/20201128224514/http://oni.bungie.org/forum/viewtopic.php?pid=51523#p51523 A response] in an OCF discussion how much apocalyptic 12/3 really was:

'''Can you trust her?'''

Condensing: Your biggest concern about a sequel is the post-apocalyptic setting which is based on that one statement of Konoko. 
> Mankind as we knew it is doomed: the Chrysalis will change us all. Let's hope it's for the better."

Don't trust that TCTF trained guinea pig. ~chuckles~ 
Educated with finest WCG propaganda. Isolated from other children and the outside world most of the time. Someone that would prefers the world's destruction in place of negotiations with Muro - even if it's just to buy time - must be nuts (or doesn't know it better due to indoctrination). Can you trust such a person? She stands in one burnt city and claims only the Daodan can help. She has no clue and sees only what made her strong.

'''Fix the apocalypse''' 
> Another possible solution is to stretch and slightly alter the existing story by coming up with some kind new element that suddenly makes it possible for things to evolve in a different way.

No need to invent anything. 
> You have found a possible weakness in Muro's plan. If the Sturmanderung Pulse can be activated before all the orbital transmitters are aligned, some of the Atmospheric Conversion Centers will survive.

To sum it up: not all countrysides have ACCs and abusing the activation sequence will even save some. I only see a 50%-effective apocalypse. smile

> The World Coalition Government realizes the extent of the ecological damage and has the ability to reverse a lot of it but has decided not to. It is in their best interest to maintain the centralization of wealth so the large population centers are preserved while "third world" regions are not

The TCTF's job is to fight and prevent tech crimes. Their second task is to control prohibited tech e.g. by running the TCTF science prisons.
After (Konoko's overdramatized) ACC destruction the TCTF would be forced to disclose their gathered knowledge. If they refuse the angry mob will pay them a visit. One obvious demand could be to mass-produce SLDs to do all the outdoor work.

That's why I think that a sequel doesn't necessarily need to be totally post-apocalyptic.

<hr>

Also (again), questioning and improving other points won't hurt. 
* The Sturnanderung plan itself is nuts too, there are missing points. But the main problem here? Muro raids Vago in last minute "to steal experimental gene surgery equipment." Really? *Who* said this? Shinatama? 
Daodan implantation is a core element in Muro's plan. Quite late bro. I would expect the Syndicate to already have that technology. Indeed the implantation is listed before worldwide ACC upgrades (which probably took months or even a few years).

Tertiary Stage:
:9) Daodan core technology (ref.TITAN\uwlb)
:10) STURMANDERUNG mountain compound construction
:11) Symbiote candidate selection and implantation

<<<Tertiary Stage: COMPLETE>>>

They are done with implantation.

Not only statements should be questions, also actual technology notes so that we don't run into later pitfalls.
* Shields: you can't see magnetic and electric fields
* Plasma rifle: plasma can't accelerate itself nor would it stay in shape unless it is hold together by something

Such errors steal attention from the actual story.
: --[[User:Paradox-01|paradox-01]] ([[User talk:Paradox-01|talk]]) 20:48, 23 June 2017 (CEST)
|}

A 50% cataclysm is just as bad as a 100% cataclysm if people fight each other for remaining resources? Might be. Someone must step up and provide stability pleasing human basic needs in such situation. META. A wild mix of WCG, moderate Syndicate, BGI and industrials - more doers than talkers. Since the wealth will remain centralized just after the worst has been fixed (or not) the kicked out losers from the old factions and radicalized people will seek to secure the resources by their own hands. [[Oni2:Phoenix|Phönix]]. None of these entities is homogeneously which causes various inner conflicts.

==Camp Sturmanderung==
Strikers prefer to say "Camp" as code name for the whole complex. Most of of it lies underground.

It's "hosted" by GUR as more or less official maximum security prison. (It was the Syndicate price for helping GUR during the Great Uprising.)

Death penalty is still supported by GUR's law, that way the Syndicate can cover their "new deals" towards their inmates. Sarcastic voices name it also "gladiator farm".

The underground complex contains facilities for research (by supercomputers), production (including Daodan and heavy weapons), and a TITAN module.
Needed electricity is in great part received from a beneath lying [[wp:Geothermal_power|geothermal power]] station which works as [[wp:Closed_system|closed system]].

==Comguys==
WCG is basically the Chinese state model with everyone getting used to it, giving it one or two more generations. Those who do not agree live a difficult life. The open source movement is not what is used to be, either. WCG is controlling open source now. "Digital rebels" are thereby forced to act against WCG's law and order, stigmatizing some as criminal and black hats who would have not been in the past. This oppression of free will resulted in individuals to actually oppose the WCG. Growing radicalism of gray hats resulted in enough potential to fight back. At first it was idealistic actions, then money was involved, leading to corruption of their own ideals they once had.

In Italy, mafia structures were attacked to clean up the political landscape. But digital tools made it easy to get involved, blackmailing mafia and linked politicians, eventually taking over the business. When physical and virtual reality merged, the "Network" became new head in line of command. As Comguys they were secretly directing the Syndicate.

Network (hidden leaders: "Controllers", top-tier "Comguys" that use the Subbosses as "proxies")
|
+-- Syndicate (official head: Muro)
| |
| +-- Subbosses (counter parts of regional TCTF commanders)
|
+-- BGI (tries to detach from the Syndicate)
|
+-- Musashi Manufacturing (was sacrifieced by Muro to hamper BGI's anti-Sturmänderung plans)

The Controllers are corrupt hackers, endoparasites within the network of crime organisations. The existence of Mai and her Chrysalis reminds them of their Arnachist mission to end all national geopolitics by crashing "all systems" although most of the time they use the more ambiguous term "the system".
: As the Syndicate is already a network of SOC, Network members sometimes describe their entity as "'''meta organisation'''".
: The creation of Avatara (as a proof of AGI) is what they were actually waiting for. The Daodan poses a system disturbing but also ''rivaling'' threat that can only be used as a political distraction in best case.
: The operation "great reset" of the Controllers was named as such to make fun of [[wp:Great Replacement conspiracy theory|Great Replacement]] and [[wp:Great_Reset#Conspiracy_theories|Great Reset]] conspiracy theorists. In an post-AGI world "capital" gets kind of irrelevant and by exponential growth a robot infrastructure can create habitable conditions in every corner of the world so that migration flows mostly stop.
: However, in the upcoming chaos that all involved parties cause - including Sturmänderung "Plan B" - Avatara does another kind of reset: He seals the mind of all humans in hope that this will give him enough time to repair the un-aligned Gaia AI.

The controllers concluded they couldn’t destroy the system without becoming a part of it for reasons of power.

Controller: "The WCG is the real Syndicate. -- The superpower cartel."
''Something New'': "What about Gaia?"
Controller: "It's the ''forth power''. But with an important difference. Its ''zone of influence'' is everywhere."
''Something New'': "I see what you are trying. But that will not work..."

In the early years, before the founding of WCG, they thought of uniting all smaller countries against the superpowers. But then they predicted if such a threat was about to emerge the superpowers would team up in cutting the cake and suppress all opposition mutually. Therefore invading the forming WCG in its entireness would be pose a better chance for success. However, they lacked the tools to do so.

Although Mai never interacts with that group directly(?) she would reject the controllers because of her TCTF imprinting.

==GATC==
'''(*)''' Gathered Anti-Terror Commandos

GATC was formed during the Great Uprising in 2032 by a resisting third of the United States known as "New Confederation". (Its constitution was in great part like the old one.)

The [[wp:International_Emergency_Economic_Powers_Act|International Emergency Economic Powers Act]] allowed to claim an "unusual and extraordinary threat... to the national security, foreign policy, or economy of the New Confederation". And GATC was ordered to take down this "threat" because the so-called World Coalition Government ([[WCG]]) was going to be founded in claim for sole representation - no market or nation should be left. Minorities were going to be ignored.

A fight between native people was a no-go. So, GATC took chance to team up with other WCG opponents (including later the "[[Syndicate#History_of_the_Syndicate|Network]]" and the "[[Restless_Souls/Summary#Shinobi|Shinobi]]").

Africa had many resisting countries so GATC used the situation to set up a "[[wp:Proxy_war|proxy war]]" there.

However, they lost the war. GATC kept operating in the underground - financed by pro-NC concerns mainly military industry. GATC is marked by using cutting-edge technologies in faith to ensure their success that way.

==GATC: Blackstars==
Blackstars is that special platoon (counted 40 units at beginning).
It is GATC's elite executive but their existence is official denied. Sort of a modern "[[wp:Jin-Roh: The Wolf Brigade|Jin-Roh]]".

Blackstars claimed themselves to be a mercenary group in 2034 after the war. Via Blackstars the GATC administrative keeps ''in contact'' with the Syndicate which had become hostile towards them.
 

GATC obtained nuclear material to expand their arsenal. They tried to recover an broken arrow from the coast of Georgia and a reactor of an sunken Russian submarine. These mission were highly risky and eventually had to be canceled. In recent years they went on to use sea water filter technology. They infiltrated a GOP facility that desalinate sea water. Elements in solution can be separated by the differently sized pores in graphene oxide membranes. By mixing in uranium contaminated soil they accelerate the process. By that they can not only obtain heavy water but also plenty of uranium. They are thus able to construct fission and fusion bombs.

GATC supports their elites with a bunch of cutting-edge technologies which include many parts from Syndicate and WCG. Besides the Daodan they have their very own highly advanced bio program Spare. The ultimate application of Spares are framed by "liquid SLD" and transport means that includes an end-stage [[wp:DARPA_Falcon_Project#HTV-3X_Blackswift|carrier with scramjet engines]]. Liquid SLDs are robots made from special SLD cells. They are not meant to mimic humanoid combatants per se. The cells allow for highly modular designs - or as the GATC sci say - for liquid designs. The robots can adapt to many situations on the battlefield by changing their bodies. They can also divide into smaller units to form swarms or fuse all together for heavy tanks and mechs.

When GATC decided to evacuate Griffin from a hospital under attack by the Syndicate they sent a Spare with all its support layers. After touchdown the liquid SLD created a [[wp:All_round_defence|perimeter defence]]. They were meant to buy time so that Blackstars could "install" [[Restless_Souls/Technology#Security-relevant_aspects|Griffin's Spare]].

==GOP==
Guardians Of Paradise?

[GOP symbolize what religious fanatics could end up doing if they get overstuffed with technology.]

===Origin===
GOP is a transhuman organization at its core.

They aim to augment humans with technology to create so-called Omega-Chimera. This is to fully control human evolution and avoid getting replaced to potential AI beings. When WCG declared some technologies to be dangerous for world population, the transhumanists saw them to be hindered in reaching their goals. They began to gather all kind of equipment and brought them to remote places in the Sahara. Their villages changed location a few times since then. The most important money sources are former Russian oligarchs. A few of these bakers even life there.

===Symbiosis with religious individuals===
Work force is provided by religious groups and individuals that share the goal of a devout, peaceful, autarkic community. The bakers put much effort in recruiting and missionizing people with the most "silent", loyal and submissive behavior. The use of cutting-edge technology is not propagandized, the administrators rather try to blend it into daily life. The community's growing success is interpreted as God's goodwill. And as harder the people work as higher will be their rewards.

Conflicts are rare as the transhumanists and well-informed workers can agree on high-tech being tools to reach paradisiacal life conditions, health, great knowledge, physical power, immortality, etc. Worries were rationalized: as men were formed in God's likeness - and ultimately being his children - it is no sin to become better. Children do grow. And so do God's Children. While doing so, they right for the biblical [[wp:Original_sin|original sin]]. God punishments are seen as exams while also following this order:

:''Then God blessed them and said, "Be fruitful and multiply. Fill the earth and govern it. Reign over the fish in the sea, the birds in the sky, and all the animals that scurry along the ground."''

----
[Replace this with "eternal sin"?]

When all goals of GOP have been accomplished, the members would have proven themselves worthy to witness the [[wp:Jehovah%27s_Witnesses#Eschatology|Second Coming]] and allowed to remain on Earth.

While the Second Coming was actually propaganda, the cataclysm put GOP's religious workers into so much euphoric mood that they scared many GOP transhumanists. Some critical voices used the heat to kick out everyone that didn't seemed to be a true advocate. Eric Morice, himself a scientist, retained control over the systems but acted now fully in what he thought the members would expect next. Jesus would not appear very soon... To buy time for a plan, he said that they still needed to endure the appearance of true evil. He built some ''demonic beasts'' (Behemoth, Leviathan, etc.) in Green Village's inaccessible laboratories. The Bioc would set them free. Their presence would be a proof for Satan's actions and the Holy Sand could wipe them from the face of earth. All what was missing was someone that could act as Jesus. Preferable a Daodan host that could miraculous heal his wounds and those of others.

===Temporary partnership with the Syndicate===
While the Syndicate is happy in having such a well-paying customer for illegal technology, they also became interested in what GOP actually does. The Syndicate never does business blindly with any customer. With their paramilitary division on the same continent GOP had no much of another chance than to share technologies they developed on their own. The Syndicate is always looking for a way of making their HQ more autarkic and unnoticeable. For instance to camouflage underground facilities from civil and military satellites, infrared information can be altered by [[wp:Adaptiv|"camo layers"]] which origin dates back to 2011.

===Bioc sand===
When GOP got an sample of Bioc in their hands they used it as smart concrete. Their buildings can now be grown from basically just sand and electricity. Soon they used it to grew "solar harvester". These look like wide areas of black sand. The areas are protected by dense dust clouds up to heavy winds that emerge as soon as strangers appear. Magnetic fields can turn particles into devastating storms and tornados against men and vehicles. After recent improvements GOP began to transform the entire Sahara into "holy sand". By now they are even able to create fast moving dunes, earth quakes and quicksand. The Syndicate no longer sends personal after GOP since nobody returns anymore. All phenomena draw either on magnetic fields or mechanical resonance from Bioc sand layers. With technological advancement GOP would be able to move the sand into other countries. The "sand" is its own information, computation and transport infrastructure, energy production site and weapon.

Because of the biblical context, GOP created a new deterrence. These "salt pillars" - technically speaking bioc sand pillars - grow around enemies and eventually trap them inside and prevent them to breath. This is as much as effectively as it is frightening. Soon the pillars were modified to additionally paralyze victims by means of electric shocks to ensure the victim cannot escape in the early stage of pillar forming. A last upgrade was developed to combat hard targets: the pillars grow rings to grind vehicle armor at high speed. All these pillars can be used to fossilize targets and return them to the surface as deterrence should new enemies appear at a later time again.

===War with Avatara===
GV has all the data to design and populate planet Earth with bioc hybrid organisms. The WCG could switch off GV's access to the global sci grid anytime but cannot prevent that it would connect to the computational capacities of the Sahara.

Mai and Avatara has no other option but to fight the sect since GOP's hostile behavior escalated with the attack on GV.

Avatara refused to act as a new messiah. Instead he uses the Sahara to accelerate the construction of Gaia.

===Mind Seal===
Technological threats were going to be omnipresent: in the ground (Bioc AI), in the air (Aether AI), in the water (Kage-Hasegawa), in the new hackable pseudo-SLDs, inside the human brains (Traton's machine cells), inside any other biomass (Xeno-Daodan).

The corruption of Shinatama and Gaia by the Network would unleash chaos of unknown scale. In an act of desperation Avatara established the Mind Seal giving himself hopefully the time to sort things.

==Green Village==
===Inspiration===
* GV might be located at [https://www.google.com/maps/place/Vitimskiy+Zapovednik/@57.7146445,109.6192272,4.96z/data=!4m5!3m4!1s0x0:0x27cdbc7d0e5a6cf6!8m2!3d57.2026682!4d116.8077978 Vitimskiy Zapovednik]
* At the periphery of the quarantine zone there is a city similar to [[wp:Neryungri|Neryungri]]

Green Village is a huge research complex dedicated to environmental-friendly, or "green", technologies and the wide field of genetics.

It is connected with its sister facility Silver Village through the "new global sci grid" which also Avatara used for its Daodan computations.

Both, Silver Village and Green Village, are TCTF science prisons. As WCG's two most important research facilities they are not only guarded by TCTF but also WCG military. In 2041, they decided to build another military base near Green Village.

Green Village, Silver Village and the Tianxia Institute are connected among each other. Officially they have not conducted a joined project so far.

===Bio Crisis Plus===
Are giant viruses and other prehistoric microbes a risk for current life? ([https://web.archive.org/web/20230509152213/https://www.tagesschau.de/wissen/gesundheit/zombieviren-permafrost-101.html Invasive Arten aus der Zeitkapsel Permafrost?])

What are the consequences from the rough mycorrhiza? Monitoring and quarantine protocols?

===After Sturmänderung===
Muro left a power vacuum in the Syndicate. Kumo was one of who tried to became the next boss. His first step in doing so was to build up his own, infinite stock of Daodan Chrysalises.

He gave his elite teams the best equipment money can buy (and security codes from BGI) to infiltrate Green Village and steal research data about WCG's Daodan so he could produce any number of them. The team was said to transmit the data and retreat again. But Kumo knew that it was very unlikely they would make it out alive. However, Kumo thought that the cataclysm was the perfect chance for such risky move.

[[#GATC|GATC]] knew about the Syndicate operation and decided to intercept by nuking the complex. The administration took the chance to trigger a new war between Syndicate and WCG. They aimed for the fusion reactor to maximize the nuclear contamination and scare off other invaders. However, Daya and her team had been selected for the Sturmänderung program which made them DC hosts. The Syndicate team has little trouble to adapt to the hostile environment. The actual problem was that they had been wasted by Kumo and they didn't knew it. The extraction of the teams was not going to happen.

GATC knew of how the Syndicate was structured and that Kumo was after the Daodan. They decide to offer WCG their men as emergency response team to capture the Syndicate team. The plan was to eliminate them so no further investigation could be made reveling that the Syndicate was't responsible for GV's destruction. Mai has been recently recruited by Blackstars so before realizing GATC sent her there too.

As it turns out there is something more dangerous in the area than nuclear contamination or enemy forces. Rogue bioc patterns hunt for any kind of biomatter - plants, animals, human, not caring whether WCG, GATC or Syndicate. This let WCG to establish a quarantine zone.

The Bioc kept growing turning normal people into "wanderes" and Daodan hosts into seemingly supernatural nature spirits before they eventually merged with the main mass when the Daodan lost its battle against the Bioc infection. After a few skirmishes everyone that had survived in the zone came to the conclusion that they were on their own and only together they could survive.

Meanwhile BGI was tasked to secure the area. Because of political power games they sent Sarai to take in Mai, the initiator of the cataclysm - also they had to settle a score with her. Mai had infiltrated BGI and destroyed the Iron Demon a few days ago that was supposed to kill Muro. Mukade wasn't able to help Mai as he had to chase after one of the Bioc spirits. He realized that they needed a Daodan host that lives in stable symbiosis with the Bioc. But allowing the host to move freely meant to risk contamination of more areas. Eventually he fought the host and secured it in a Syndicate location not knowing that the old "Controllers" were also interested into the powers of the Bioc. By then WCG planed to purge the entire region. Mai and Mukade running out of time to save the people.

All infected individuals are bought back to GV - to get burned away someday by a shower of nuclear bombs.

----

Someone within GATC knew that Griffin still hided the puppet master technology and that the large-scale nuclear sterilization won't stop the Bioc. They sent a team to Griffin to bring him back. But Griffin got lethally wounded by Saomi and needed a "spare".

Traton sent Saomi into the desert where she found the GOP and Muro. While GOP prepare for Armageddon, Muro and Saomi tried to escape.

When Sarai was no more Mai went to GOP to stop them. After that she returned to GV to fight the remaining GOP forces. ??? Mukade messed with one special specimen in the underground labs. He entered the battlefield determined to kill the bioc spirit he thought being out of control.

Mai used her Daodan QC to control the Daodandroids and fight the WCG soldiers. The neural load was massive that it drove her into total exhaustion. Shin continued to use her body. At the same time Shin got fooled by the Controllers who used her as a trap for Avatara.

===Silver Dawn===
Mai fell into the hands of Black Phönix that defies META. They regenerated her over and over which destroyed everything that was left of her original personality.

Muro escaped GOP and sought out Ryu to start a new life. They had a lethal dispute with Black Phönix in which he had to fight Mai eventually. A static metamorphosis regenerated her brain from the ground up - and some of her memories in the process.

Together they aimed to fight Traton who got the puppet master program. Meanwhile Avatara had a skirmish with Aether. He recognized the distraction and also that he had already lost control over Gaia. In an angry act of despair he prevented Traton from using the puppet master program. "Enough of this bullshit!" Avatara unleashed Mind Seal.

===Mind Seal===
By Shin's misguided interception also GATC AI Sophia was "liberated". Having "awakened" the AI sought Mai for help. Together they hunted the Network. Avatara had become more and more powerless due to his own ethics and the political shockwaves the Aether incidence caused.

Sophia wanted Mai to act as a new nature avatar (last decision instance) since Gaia had switched political sides with the Network.

Muro went into deep Earth support structures of Gaia, hunting enemies and knowing that he might never return. (Oni type "Gatekeeper of hell".)

==GUR==
'''(*)''' Great Union of Resistance

[Formed by most of African and a few Middle East countries during the Great Uprising. -- Needs adjustment/rewrite due to changed background story which includes China.]

From the [[Restless Souls/BC0|prologue]]:

:''A second front was on cultural basis. Developing countries and states of the Islamic world saw the annexation of their (living and) economic zones as another cheating by the Western World; the "Colonial Legacy" deemed as proof that capitalism brought only harm.''
:''The ongoing radicalization of both sides and smaller escalations gave WCG the possibility to propagandize the "[[wp:Clash_of_Civilizations|Clash of Civilizations]]".''

==META==
Basically the coalition of moderate WCG and Syndicate forces. After the Cataclysm neither of them can survive alone anymore.
Traton became the head of META after he stole the puppet master program from Griffin.

==Mind Seal==
<s>Mind Seal event becomes only possible by Silver Dawn. Ter Hasegawa is trying to disempower humans for their own sake. "Machines shall become our guards of power since we rather go to war against ourselves than to protect ourself." This act makes appear enemies of course... Mind Seal is meant as temporary solution until a Biocracy can be established.</s>

* [[Restless_Souls/Summary#Mind_Seal]]
* [[Restless_Souls/Summary#Silver_Dawn]]

==Operation Proteus==
Traton's PR attack and final hit on WCG. He polarizes the masses and let chase them state institutions like TCTF.

==Shinobi==
{|border=1 cellspacing=0 cellpadding=4 style="float:right; width:100px; background-color:#FFF"
|style="margin-left:auto; margin-right:auto; text-align:center"|
'''忍'''
|}

(Shinobi: another word for ninja)

Ninja's golden age was during the [[wp:Sengoku_period|sengoku period]] (1477 - 1573). Then the Ninjutsu schools (Ryû) began to disappear again. The rest was further reduced after Japan had lost WWII - they were prohibited to have any martial arts. But, however, some Ryû survived.

Then there was a reviving of the Ninjutsu. WCG's declaration meant also the loss of Japan. Terror groups arose to force their own Government to refuse the this union. These groups weren't very effective despite of modern weapons. Then there was a ''notable'' attack. Three men covered as security personal took down all the others and got the conference under their control. The minister had to read the group's reasons not to join WCG in front of invited reporters. This was ''just'' a warning. The three left as soon as the special forces began to storm the building. This created a new myth of the Ninjutsu.

The Shinobi absorbed other radical forces. But homeland Japan was lost, in the end they couldn't keep pace with WCG security arrangements.

They teamed up with GATC and Syndicate to fight WCG on last battle fields. It was a matter of strength again. GATC fell back - caring their wounds. And Syndicate tried to ''lull'' Shinobi by forming them into a stronger and guerilla-like force.

Old non-TNZ idea idea:

Meanwhile - Mukade worked too closely with Syndicates. Muro's provides him a Chrysalis. That corrupted Mukade slowly.

The Shinobi were actually never conform. But Mukade create an inner conflict. He was about to win members for the Sturmanderung ideology backed up by reinterpreted Ninjutsu philosophy.

Time passed. The resisting men were quite hopeless and ''said goodbye'' to their homeland already. They realized Sturmanderung's madness but are afraid to rise against Mukade.

If just Mukade wouldn't be...

==Silver Dawn==
Silver Dawn is a [[wp:Terraforming|terraforming]] project in cooperation with United Space Administration and several research facilities. After nanomachines are inserted into a planetary surface, they start to reproduce themselves and spread over the entire planet. During this, their basic programming drives them to form neural networks [[wp:Body_image|(to be aware of its own structure)]] and diverse sensors (and receiving units) which shall also archive full control over the nanobot collective itself and give this control to outside standing humans. Now it has almost become an artificial multi-cellular organism. The bots can be ordered to form other 'organs' to collect solar energy, creep for all kinds of matter including water, produce rocket fuel and building material, and of course changing the air composition and filter toxins to make it breathable.

==Silver Village==
A WCG research complex for nanotechnology in the former USA. It's newest project: Silver Dawn. WCG tries to abuse it as weapon since nuking ''Camp Sturmanderung'' failed.

'''Participation in Daodan project'''

[[Restless_Souls/Technology#Full_body_simulations|Pensatore about AVATARA needing help:]]
:Pensatore: "I'm afraid to say that this Daodan simulation is quite a hard nut to crack. AVATARA might need help. I already talked to the AI and it says it would target the experimental quantum computing grid centered around Silver Village."

Not only that Silver Village has vast access to quantum computing capacities, it's also first to use [https://phys.org/news/2015-06-method-quantum-entanglement-vastly-photon.html hyperentanglement] for data transport.

With SV having a direct link to Green Village, complex problems can be subdivided. They get distributed on processors that suits their nature: classic (CPU), parallelism (GPU, stream processors), quantum, pattern recognition (neuromorphic chips, memristors).

To keep the Daodan secret, SV might only do [https://phys.org/news/2017-08-quantum.html blind calculations.]

This was the only way for AVATARA finish the Daodan in time.

----

Shared project with Green Village:
* Bioc

Research fields:
* Quantum technologies
* Nanotechnologies
* Computer-based sciences

Completed projects:
* Modular ammunition
* Personal and atmospheric shields

==Sturmanderung==
''Change is in the air.'' - German proverb

If you go for an interpretation with a "most obvious intent" then Sturmanderung (Sturmänderung) is best to be read as "Storm of Change" in English. In context of Muro's plan it means "a storm that wipes away the old order".

However, there can be two interpretations to Sturmanderung.
* Either it is a storm that Muro seeks to unleash. ("Änderungssturm", many, radical changes happening all in one storm)
* Or there is already a Storm raging - the totalitarian WCG-Syndicate-complex - that needs to be changed. ("Sturmanderung", change of a storm in direction and intensity)

From a lingual perspective and maybe Hasegawa's (initial) perspective the second interpretation would make more sense. Given that there are numerous gaps, inconsistencies and such inside the story we are even more free to choose.

Food for thought: Did Sturmanderung really started with Hasegawa and Muro?

Sturmanderung Megacomputer

There is supposed to be a ''Sturmanderung Megacomputer'' of type TITAN inside the Syndicate mountain complex. Probably they did not just use it for weather forecast. Maybe at some time they might have used it to simulate the toxin levels and their consequences but for the most part they likely used to virtually plan all their missions and do Daodan research.
: Inside the Syndicate Mountain Complex Mai encountered doctors who were deeply informed about the Daodan and her person. (They even know her face.)
:: Daodan core technology (ref.TITAN\ssob)
:: 15_57_16 Syndicate Scientist: Oh god...YOU! Here take these! Just leave me alive!
:: 15_57_21 Syndicate Scientist: You...you're the other prime symbiote!

===ACCs===
Mai sent pulses of highly energetic microwaves to the satellites which redirected them as re-focused beams to the atmospheric conversion centers (ACCs) triggering a cascade of malfunctions and resulted in the destruction of the facilities the Syndicate had sabotaged.

Normally, the satellites serve two functions and which does not include being a power source for ACCs because that would be highly inefficient. Instead, the satellites coordinate the ACCs worldwide and therefore mitigate the toxin levels where it is needed the most. Secondly, the satellites radiate large areas of clouds in heights the ACCs can impossibly reach. While treating the air for the cities the ACCs also inject catalytic particles into the atmosphere destroying toxins. The microwaves form the orbital array provide the energy to accelerate the catalytic reaction. Also this heats up the particles so the stay longer in air. This practice stands in contrast to limit the global warming but is tolerated due to the lack of alternatives and the increasing CO2 rules for the economy.

If the toxins in the upper atmosphere aren't treated they build up and hit the cities during changes in the weather which means days high toxin level the ACCs alone cannot cope with. The cleaning potential of the ACCs is in multiple ways limited so the satellites provide a support function.

===Sturmanderung plan B===
[Another way to kill all humans with a minimum of financial costs. Another argument to get rid of nuclear deterrence. Future dangers require demilitarization or else we cannot manage them. -- The Controller want to get rid of the WCG regime and their TCTF. At the same time they are legitimizing them by being themselves a threat.]

Muro aimed to contaminate the atmosphere so that basically only Daodan hosts survive. He needed to infiltrate ACCs worldwide and let them go out of control. Complicated, risky. How about a plan B?

Originally, the Controller thought of blackmailing the WCG with their Great Reset plan. But then they decided to put it on ice. Muro somehow got to know about it and reactivated it as his own backup plan.

How much does an intercontinental rocket cost? The [[wp:LGM-30_Minuteman|LGM-30 Minuteman]] costs 7 million USD. One unit is quite affordable for the Syndicate but they needed 500 of them.
Therefore Muro let construct the ICBMs in Russia without warheads. The simultaneous launch of that many rockets makes sure they don't get declared as a false alert. They get shot into the sky and trigger a nuclear retaliation of USA, and then of Russia. For that reason The Camp is located in Africa. ''To be on the save side.'' The nuclear holocaust and the contamination will come from the real rockets. Hence nuclear material for own warheads is not needed.

The cost were further reduced by siphoning off fuel from cities' hydrogen grid. Also the rockets are made in Syndicate run (reverse engineering) repair cafes which have advanced 3d metal printers. The Resurrection Shops are situated at the periphery of cities.
: On a political level sympathisers declare these shops a form of protest against the "capitalistic throwaway society" and "[[wp:Planned_obsolescence|planned obsolescence]]" of corporations.

The rockets are camouflaged as silos to store hydrogen. As soon as they enter the last construction phase (turned into actual rockets) they get relabeled as "weather control system". (Cynical reference to [[#Sturmanderung|Sturmanderung]].) Then they are officially meant for [[wp:Cloud_seeding#Salts|cloud seeding]] with sodium chloride (NaCl) to bring rain to the agronomic areas surrounding the cities. The TCTF might just think of them as some sort of scam.

...

Avatara was at the beach. Laying on the sand he looked into the sky, stuffed with the real ICBMs.

He sighed. "Stupid humans."

Shin: "Can you make them stop?"

Avatara: "I can make them inactive. But they will still hit the ground and cause contamination."

...

The oceanic contamination triggers Hasegawa's awakening?

==Syndicate==
The Syndicate is an agglomeration of criminal groups. But the Network in pulling the strings: they control the technological black market, ensure save Syndicate communication and finances the '''paramilitary "Striker" division'''. BGI is part of the Syndicate.

The Network was originally a black hat hacker group. The so-called council is just a bunch of virtual straw dolls.

The black hats hides within the high-rank Comguys - the Controllers. All Syndicate subbosses (regional managers) and members of the Striker division know: "never mess with a Controller, it's a death sentence".

Traton is a lower-ranked black hat, but he knew the identity of many Controllers. He supported Muro in hope to take out his competitors. Muro gained the trust of his Striker comrades and convinced them in working for him. The Chrysalis made him the only know example of a superhuman and he was willing to share his secret with them. Traton and Muro hunted the Controllers they knew of and took lead over the Network and Syndicate. The choice giving to the Controllers was simple: accept Muro as Overlord or die through his hands.

After Hasegawa and Pensatore died, AVATARA managed to accused Traton for sending Mukade after Muro's father. That wasn't true but as consequence Muro dispelled Traton. Mukade and Kimura were now depending on Pensatore's mercy to not get extradite to Muro's wrath.

(AVATARA was executing an order it got just before Pensatore upload his mind.)

The Controllers that weren't killed, retired and disappeared. They hadn't a chance against their defected colleagues and Pensatore's planet-wide influence through AVATARA.

'''Geographic retreat areas'''

: [[Manual#The_Syndicate|Manual/The Syndicate]]
When you really think about the power the TCTF wields it makes you wonder how the Syndicate has survived. There are a lot of theories: some say the World Coalition Government lets the Syndicate slide because they keep the underclass down. Others claim a '''connection between the Syndicate and the remnants of the countries erased by the World Coalition Government's land grab'''.

While the Syndicate put much effort into covering their operations in WCG territory, they have an easy job in remote regions.

: [[Manual#Tech_Note_1|Manual/Tech note 1]]:The World Coalition Government realizes the extent of the ecological damage and has the ability to reverse a lot of it but has decided not to. It is in their best interest to maintain the centralization of wealth so the large population centers are preserved while "third world" regions are not. As a bonus the mounting death toll solves some of their overpopulation problems.

Regions without ACCs and subventions are still WCG territory on paper but de facto the old governments runs these regions with help of the Syndicate. Especially in African and Islamic regions.

'''Streams within the Syndicate'''
* conservatives - BGI and now mainly dead Syndicate/Network heads who thought/think that the situation before Muro was best
* moderates - people like Traton who supported Muro's rising for their own interests and maniacs who believed in the necessity of breaking the WCG until they realized that Muro wants Armageddon
* progressives - ideological goal: recreation of mankind because the "old form" almost destroyed itself ("time for a new evolution" ''and so on'')

'''Hierarchy'''
* professional units (Striker) are "educated in the spirit of Sturmanderung"
* (Strikers aren't directly sworn to the boss or subbosses but to Sturmanderung's ideology)
* they are send to all subbosses to support their regions as long as they aren't ordered to do something that can threat Sturmanderung
* on the other side subbosses have to contribute Sturmanderung by one third of their "incomes"
* subbosses are independent in own doings within their region
* (every subboss has numerous commanders which control one provinces or city)
* commanders have their own thugs, even temporary command on Strikers needs permission from a subboss
(We still don't have an idea on Syndicate's hierarchy, this is a first try.)

'''Troops'''
{|
{{table}}
!Sub-Party
!Commando
!Unit
|-
|Mercenary
|-
|Sniper
|-
|valign=top|(Mercenary) [[#Shinobi|Shinobi]]
|"Schatten" (Shadows) "Nebelwächter" (Fog Guards)
|valign=top|Ninja - Infiltrator Class (Green), Eliminator Class (Blue), Avenger Class (Red)
|-
|rowspan=3 valign=top|Syndicate own...
|valign=top|Regulare Troops
|Comm Trooper Bomber Striker - Grunt Class (Green), Hoplite Class (Blue), Hussar Class (Red) Fury - Harridan Class (Green), Banshee Class (Blue), Valkyrie Class (Red) Elite Striker - Ogre Class (Green), Giant Class (Blue), Titan Class (Red) Tanker - Skirmisher Class (Green), Brawler Class (Blue), Crusher Class (Red)
|-
|(Meta Troops)
|(daodan-improved Syndicate folk - mainly regular troops)
|-
|Special Troops
|"Sturm"-Striker - Behemoth Class (Gray) (SLD-)Shinobi - Guardian Class (Black), ...
|}

===History of the Syndicate===

[The older Syndicate text sections should be merged with this one.]

The Syndicate needs safe land to build and test new weapons and equipment. A world-wide operating WCG is opposing that need hence the Syndicate fought against the WCG during its installation.

When the WCG tried to annex land of all countries most members of African Union (AU) and the Islamic League considered this once more as land grabbing but this time on an unseen scale.

Inspired by former land grabbing in African countries the Syndicate forcefully takes back land of multinational companies and tells the government that they can keep it if they get small share for compensation. They sabotage and blackmail the companies so they "don't want it back".
The Syndicate is political active and fuels the ideas of nationalist who are still angry about the colonial history and its persisting effects. They support the idea of independent African countries so the WCG has no control there. For AU the troops of the Syndicate are simply some nationalistic mercenaries with no official contract. The AU turns a blind eye on these troops since the Syndicate is acting in their interest.

Technology that is unavailable or under patent is provided to the AU for little money. The Syndicate makes sure the mined and farmed raw resources are not sold on the international market. Processing is done within the territory of AU which increases value and strengthen local economy.

Unplanned the Syndicate has become the most important partner in developing the countries that where exploited for more than 100 years from non-African countries and multinational corporations.
The Syndicate has become not only a strategic partner but also gained a tremendous amount of sympathy. Within the Union they have de facto political immunity. Crimes that where committed within the WCG are not prosecuted. In that context WCG activities are either ignored, blocked or sabotaged.

Like in the WCG there exists many groups of organized crime in the Union. The Syndicate set up quota for these "business" to suppress too unfavorable situations with local government. To enforce these quota the Syndicate also uses their Striker division that was established during the WCG founding war.

Union separatists are used to fuel the war economy and are eventually brutally beaten down. The military section of the Syndicate has also an easy game promoting new conflicts in South America and Mexico. Narco-state are especially suited to build up armed conflict. While the Syndicate delivers weapons to gangs and paramilitary, the Syndicate's legal front business BGI provides the WCG governments with “anti-Syndicate” weapons and equipment.

The military revenues are a nice bonus but not the biggest piece within the pie. With increasing size the Syndicate tries continuously to invade new WCG companies to have legal income and political weight. The TCTF is suspecting the Syndicate is following the Italian model. The Syndicate aims to be as much as system relevant as possible. Due to their cancerous growth removing them might be impossible without crashing the entire economy.

In the perspective of BGI and the general economic driven Syndicate members status quo needs to be protected and "cultivated". To them Muro's Sturmanderung program is just madness.

==TCTF==
Technology Crimes Task Force

{{divhide|Food for thought}}
Is UK slowly shifting towards WCG? Is it establishing a precursor of TCTF? ([https://www.bbc.com/news/uk-56413920 en], [https://web.archive.org/web/20211129143300/https://www.tagesschau.de/ausland/europa/johnson-575.html ger])

BBC:
* It is "likely" that a terrorist group will launch a successful chemical, biological or nuclear attack by 2030
* The UK will set up a new counter-terrorism operations centre to improve the response to terror attacks
* The government wants the UK to become a "science and tech superpower" by the end of the decade

----

* https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/975077/Global_Britain_in_a_Competitive_Age-_the_Integrated_Review_of_Security__Defence__Development_and_Foreign_Policy.pdf

UK's Integrated Review (of Security, Defence, Development and Foreign Policy) identified future challenges (China's economic gravity, climate change, lose of biodiversity, globalization, poverty destabilizing states) that will be worked on for the next 10 years. Technology create opportunities and risk (by power and misuse), esp. by non-state actors (companies, (Oni's [[wp:EncroChat|"Network"-like]]) organized crime, and terror groups. To defend cyberspace UK is establishing the National Cyber Force (NCF).)

Technology, science, data and cyber will play a more important roll for defence, international and national security.

From the PDF document:

"We will adopt an own-collaborate-access '''framework to guide government activity'''' in priority areas of S&T [Science and technology], such as AI, quantum technologies and engineering biology."

"State threats: we will bolster our efforts to detect, deter and respond to state threats in order to protect our people, infrastructure, economy and values from those who seek to do them harm. We will introduce new legislation to give our '''security and intelligence agencies and police''' the powers they need to tackle the challenges we will face in the coming decade."

"We will bolster Regional Organised Crime Units, in coordination with local policing and the NCA. This includes our recruitment in 2021-22 of 300 police officers dedicated to SOC [Serious and Organised Crime], as part of our commitment to recruit a total of 20,000 extra police officers by 2023."

"To counter proliferation to non-state actors, strengthening the security and safety of nuclear materials in priority countries. We will also reduce the risk of terrorist acquisition of biological agents through our International Biological Security Programme and the G7 Global Partnership Against the Spread of Weapons and Materials of Mass Destruction." (western community + China? -> getting desperate -> WCG?)

"In strengthening our homeland security, we will build on firm foundations in counter-terrorism, intelligence, cyber security and countering the proliferation of chemical, biological, radiological and nuclear (CBRN) weapons. We will seek to match this excellence in other areas, through enhanced capabilities and appropriate legal powers that equip us to meet rapidly changing threats. We will also ensure that '''science and technology (S&T) is elevated to the highest importance as a component of national security''', with a particular emphasis on growing our cyber power."

That's for 2021-2031. Given that technological development does not stop it is only a question of when, not if, we all agree to let neutral AIs to be our guardians so that a "nightmare WCG" is avoided.

What will happen to technology that will be labeled harmful at a later point? What will happen to the developers?

What will happen to the open source community? Especially the guys working on AI?
{{divhide|end}}

This entity has a broad competence spectrum. As a police force they are fighting hightech crimes.
To be really effective and fast in execution they also have an BlackOps division with resources similar to an intelligence agency, military and anti-terror forces.

Shortly after TCTF’s installation [[#Griffin|Terrance Griffin]] contacted the Japanese WCG representatives to warn them against current threats the task force wasn’t aware of and not ready to deal with. Griffin wanted to transfer from his mercenary group to TCTF and secure dangerous technologies. He did so and the local WCG men are very thankful for his service.

Due to the nature of operations Griffin was best suited for joining BlackOps division and helped building it up to its full extend. Through Griffin influence over-proportional many US soldiers are now working at the Japanese TCTF HQ and BlackOps.

"Terrance Griffin is a valued Agent who has devoted his entire life to the TCTF. [...] We at the Directorate have been willing to overlook his methods because he has done more to oppose the Syndicate than any other Agent in the TCTF […]"

Without Griffin the TCTF wouldn’t be the capable force it is today.

===Area of operations===
* stopping illegal technology transfer, sale, and use
* securing illegal technology if necessary by BlackOps
* arresting criminals and renegade scientists
* running and protecting TCTF science prisons
* investigating any kind of Syndicate activities

===Science prison===
{| class="wikitable"
| The idea of a science prison is not so new. After WWII German scientists were working [[wp:Alsos_Mission|more]] or [[wp:Russian_Alsos|less]] willingly for big secret American and Russian nuclear bomb research complexes Los Alamos ([[wp:Manhattan_Project|Manhattan Project]]) and Arsamas-16. Communication to the outside world was strongly regulated (censored mail, no phone calls).

----

Another parallel can be drawn with [[wp:Black_site|black sites]]. In the name of war on terror the USA had secret CIA prisons around the world. If you replace terrorists with ''renegade'' scientist you pretty much have it. The USA was democratic system willing bend human rights to run these facilities.

How many steps away is the USA from a WCG?
|}

Inspired by the Russian-Chinese technology philosopher Kusnezow Feng the WCG bought the idea of "secured research" to the next level.

According to Feng due to their increasing accessibility certain technologies posed a such high danger for world peace that their continued research were only allowed in sheltered facilities. Any result from these complexes becomes classified.

During the years WCG installed more and more of such facilities. The biggest and "top level" ones are known as Silver Village (USA) and Green
Village (Russia).

===HQ===
The HQ and the rest of the cities are embedded in a network of sentry drones.

====Damocles====
Inhouse AI. Shinatama is connected to it at the center of the HQ's upper main hall.

====Omega Vault====
There is a pit beneath the defense platform. It can be speculated that it was meant as a place to temporary hold Daodan symbiots captive - or even to kill them. This applies to Muro and Mai should she run out of control one day. Therefore placing Shinatama there was a decoy.

This safety measure is just one in a series including Shinatama and the neural links for monitoring, the [[Quotes/Consoles#Chrysalis_Removal|experiments on Chrysalis removal]], the [[Quotes/Consoles#Sytropin|Sytropin injections, the freezing chambers]], and the [[Quotes/Consoles#Superhuman|order of Mai's trainer to carry (VDG) tasers]].

==The Tianxia Institute==
{{divhide|Fictional entity}}
The Tianxia Institute is a fictional entity. It is not related to the Tianxia Academy and its connections in any way.
* http://web.archive.org/web/20230524131052/https://www.tian-xia.com/
* https://longtermrisk.org

{{divhide|end}}

A Chinese state-owned think tank. They possess vast computing capacities to run global simulations.

The regional government uses these simulations to test new policies. It is the new hyped decision instrument.

Unused capacities are used by the Chinese research community which is constantly monitored by the Chinese TCTF. Although no official numbers are given the dimensions behind this institute can be compared with Green Village and Silver Village.

That way each former super power has a research complex on its ground. It would be naive to think that national thinking and competition does not exist anymore.

==Vago Biotech==
What was Muro's reason to ''visit'' Vago Biotech?

The name suggests research on biotechnology - and so does their slogan "Life is for everyone" - and there are these green bio disposal pools - but the consoles are about nanotech - SLDs - and the Syndicate just seems to kill the scientists. Though, the presence of Muro's Comguy hints that some massive hacking was going on two. Or some sabotage action, that needed hardware access.

The Syndicate possess adult SLDs while the TCTF doesn't. Maybe they copied their data, delete the originals and killed the white coats to keep their advantage towards TCTF.

Or did Vago found a why to combine bio and nanomachine cells?

: [[Quotes/Objectives#CHAPTER_03_._PUZZLE_PIECES|Chapter 3: Puzzle pieces]]: ''Muro and his Strikers have invaded this lab to steal experimental gene surgery equipment.'' As theorized on the Vago page, this equipment could help Daodan implantation. But that idea has a little flaw: the time point. Shouldn't Daodan implantation be guaranteed before infiltrating ACCs worldwide? If ACC infiltration would have been discovered, at least they would have the Daodan before WCG-Syndicate war gets hot again.

Well, the [[Quotes/Consoles#CHAPTER_14_._DAWN_OF_THE_CHRYSALIS|Sturnänderung schedule]] looks weird anyway, maybe let's ignore that.

The Syndicate should had have enough time to make progress with Daodan implantation. We know there were scientist in the Syndicate mountain complex, and Mukade and Hasegawa were contributing to the Syndicates database too before being interrupted by Pensatore. Maybe the process was working but not to 100%. There is something strange about Barabas: he is a cyborg. Why cybernetic implants when he has a powerful DC?

Maybe Muro and his men did simply both, stealing the gene surgery equipment (seeking a 100% implantation success rate) and the data to combine bio and SLD cells. They could produce a daodanized clone army - with SLD brains for ensured loyalty.

But there are other forces that would profit from that merging technologies. Who has informed Muro that an exceptional agent would face him soon? Both, Mukade and Pensatore, probably seek to become human again someday. And both did knew what happened to Konoko and Kerr.

==WCG==
===History===
Napoleon once said: "China is a sleeping giant. Let her sleep, for when she wakes she will move the world."

Spite the '''European Union''''s goal to show more united strength in the global power game, it remained a '''paper tiger''' compared to the actual super powers. The member states were constantly quarreling over domestic and foreign policy with no clear vision for their own position in the world. This self-made chaos, the poor status of digitization [https://www.spiegel.de/netzwelt/netzpolitik/ai-act-die-eu-vernichtet-die-ki-zukunft-des-kontinents-kolumne-a-a2b607aa-ebb0-4878-8f9b-13978a5a3a70 and AI] and the missing ownership of companies for the digital economy (hence even more dependency to USA) were all hampering factors which made it very easy for China to pass the EU in power. 

China's ambitions are basically everywhere. They reached '''economic dominance'''. Ultimately China had created strong dependencies in the [https://edition.cnn.com/2020/11/16/economy/rcep-trade-agreement-intl-hnk/index.html Asian-Pacific region], in [[wp:Sino-Latin America relations|South America]], in the EU by having build a new silk road, dupe them in trade contracts, getting shares in key industries/companies [[wp:Desertec#High-voltage_direct_current_(HVDC)|including energy production]], farming their know-how for their own [[wp:de:Made_in_China_2025#Strategische_Zielsetzung_bis_2049|technological development]], then [https://www.heise.de/hintergrund/Missing-Link-Wie-sich-China-zur-Normungsweltmacht-aufschwingen-will-6146295.html declaring their own market controlling standards], in the end turning EU into just another export market. Also, [[wp:Africa–China_economic_relations|China invested]] so much into African [https://www.nzz.ch/international/chinas-palast-diplomatie-in-afrika-ld.1692436 governments], companies, infrastructure, and military goods that they trapped [https://www.forbes.com/sites/wadeshepard/2019/10/03/what-china-is-really-up-to-in-africa/ Africa in debts] or shares and mostly removed European's and American's influence from the continent. China needed Africa also to outsource the production of low-value goods and get cheep raw materials. (For this reason later renegade US states and their military (New Confederations) had chosen African territory for their proxy wars. They wanted to thwart China's growth strategy and hinder the installation of an all-enclosing WCG. The African states still remember [[wp:Scramble_for_Africa|Europe's phase of colonialism]] and hence have a somewhat open ear for the NC's actual pretextual arguments - to fall into new dependencies - but see it difficult not to continue trade with China.)

The strongest dependencies China has created can be found within their new "domestic" Asian-Pacific market. One state after another became lost in China's economic and '''therefore political gravity'''.

Having all this power China began to aim higher. By now they could risk being independent from USA if they really wanted to. Therefore '''selling all their US debts''' – sometimes named "'''nuclear option'''" – became a much less theoretical option for '''blackmailing'''. This problem grew when China had a cold war with USA - forcing them to spend so much money in an arms race that the old super power almost reached its limit in serving its debts. China almost dead-raced USA as USA had done with the Soviet Union.


For a long time Russia had intended to stay an independent player but given enough push and pull factors they very silently accepted being China's '''junior partner against their common enemy''' USA. Meanwhile Russia kept delivering wood, oil, natural gas, thorium reactor ships and military goods. [https://www.researchgate.net/publication/262485473_The_Russia-China_Security_Partnership_in_the_Asia-Pacific_Region_Conjectural_and_Structural_Dimensions Russia helped out in securing the Asian Pacific region] against USA's "return to Asia" policy which in turn forced Washington to focus less on Eastern Europe - especially the Caucasus region.

Meanwhile Kusnezow Feng, China's renowned and respected star philosopher, wrote a number of scenarios in which the world would turn upside down in best case or witness great filters in worst case within the next century unless mankind would act in unison.

The latest '''pandemic''' posed a potential '''hypercrisis''' which made it '''easy for Feng to promote his warnings'''. In a time of new trade wars and arms races, while there were so many global debts, fighting climate change and other problems – one crisis starting or reinforcing another – seemed a very likely threat to everyone.

Fully trusting Feng and having "waked up" the Chinese government wanted to counter these scenarios. Using their economic power they forced the other super powers to establish a global federal super state. Officially, it was supposed to be a massive revamp up version of the United Nations which China – [[wp:United_Nations#Funding|with the guaranteed US shares – had already under its control]].

Inside a united world Feng saw no more use of most national military. In fact Feng took a page from Eisenhower's book – an utterly respected ex-president of the United States who warned his people about the [https://www.youtube.com/watch?v=OyBNmecVtdU&t=521s military-industrial complex].

Eisenhower also had been a five-star general which gave Feng at least the minute chance to reach Americans' "military soul".
: "Every gun that is made, every warship launched, every rocket fired signifies, in the final sense, a theft from those who hunger and are not fed, those who are cold and are not clothed. This world in arms is not spending money alone. It is spending the sweat of its laborers, the genius of its scientists, the hopes of its children."

So to counter the scenarios more effectively having less military for more GDP was very welcome although a phase of difficult transition was needed to be overcome: the physical structures being "butter and bacon" for many ([[wp:List of countries with highest military expenditures|billions of dollar each year]]), serving in military being a patriotic duty and being a tradition in many families.

The American government was grinding their teeth but eventually agreed to the idea of a WCG.

However, Eisenhower's idea of an "'''alert and knowledgeable citizenry'''" had been mostly '''replaced by a paranoiac world view''' where every man was a potential threat, a terrorist, who must be observed, tracked, analyzed and ranked. This world view was '''hold by all three super powers''' – like their increasing despite for independent journalists and whistleblowers. This meant a shift away from military towards a '''system of total surveillance''' and "[[wp:Social_Credit_System|social credit]]" to frame the mind of the masses.

America agreed on the condition that, among other reforms, all debts were removed. They thought that could give them the chance to escape the Chinese grasp one day again.

Feng wasn't really happy about WCG being that much totalitarian but accepted it as a "necessary evil" - until something better could replace it. Feng's and Pensatore's envisioned Biocracy and Gaia AI was going to be that kind of replacement.

===Inclusion of cold warriors and nationalists===
China had to make some realpolitical concessions. The military-industrial complex with its four pillars - the war industry, the military, the politicians and the think tanks - have created an own nationalism-flavored ecosystem ensuring many jobs in many states, especially in those of Superpowers. The interconnection makes it difficult to dissolve the MIC. '''Plans for a spontaneous dissolving would have caused mass unemployment and political and ideological resistance.''' A closing of this complex could only happen over several decades. At the beginning most people involved were guaranteed to continue serving their nation's security. It was an "inclusion" of cold warriors and hardliners of old nationalism. A special problem was the removal of nuclear weapons. The cold warriors were hardly willing to give these away as the MIC in other states continued as well. They argued that the weapons would be an reinsurance until WCG would have truly matured. So under the surface of WCG the silent threat of nuclear deterrence still exists. [[#BGI|BGI]]  was tolerated to absorb old military to also mitigate the influence of old nationalism in MIC.

===Demilitarization: Because weapons are a financial dead end===
The US-American MIC cannot simply be made disappear. The mentality for permanent armament has been fortified by a militarized history, self-image of supremacy, sense of mission to defend democracy (and other interests) worldwide with use of weapons and by the fear-mongering lobbyism of NRA. Owning weapons has become part of America's cultural DNA. On the other hand lethal violence and acts of wrath created a self-fueling dynamic in the impoverished social classes.

'''The people needed the economic crash to realize that in the end they cannot eat weapons.''' The spending on private weapons and state-owned war machines took away from their own pockets and betrayed them of development opportunities. (Overemphasis of Eisenhower's words of wrong budget spending.)

China exhausted USA in a new arms race. Seeing them and world economy almost breaking down China's leading thinker '''Feng realized as well that - no matter whether foreign contractors were involved - the arms industry just burns money on a global scale'''. Money that the ordinary people would need badly in the future. (Climate change, biocrisis, mitigation of global existential risks.)

With the installment of WCG smaller states were "encouraged" to give up their military very soon so that they could concentrate on maintaining and modernizing the many different types of infrastructure, foster research and guarantee a minimum of social security while a future-proof economy was the new most top objective. Military enforced geopolitics and proxy wars were no longer tolerated - as well as any other kind of war. Borders stopped existing on paper. For these reasons - and to beat down any dissenters left - the military of old Superpowers were united into the WCG "freedom forces".

===Initial ambiguity on purpose to support a transition===
As the integration was carried out step by step the initially still different national militaries could be marketed as protective powers to smaller nations. A positive meant illusion and protection against losing all face - to not end up as slaves to a different Superpower. A rest continuation of political familiarity in a yet new world order. Because of all the de-facto realities and concerns of potential partners Feng needed WCG to be integrative. Everyone should be given a plausible place, space for own yet straw doll narratives, and make real contributions to the bigger idea. Tianxia.

It was clear that Superpowers would be the last ones to give up significant amount of military power. In a division of labor narrative smaller nations and alliances like the EU were told to be the "true" forerunner of WCG by leading the "economic revolution" and fight climate change on a technological level while the "cold warrior bloc(k)heads" were "tasked" (forced by own circumstances) in guaranteeing physical security for somewhat longer, then following suit and fully revamping their own economy.

Of course not everything turned out as planned - or promised.

Competition between opportunists, bluntly corrupt elements, old ideological hardliners and new separatist movements endangered Feng's vision of a halfway reasonable WCG. Syndicate, technology misuse and Biocrisis were put into public focus to distract from the own inner over-complex problems and the simple truth that even the WCG couldn't prevent - just limit - everyone from losing wealth during the transition: to a new way of living. The debts of present and past humans had to be paid. One way or another. The longer the existing problems remained unsolved the more new doubts, frustration and self-radicalization of people and government grew which again burned resources in quarrels and prolonged the transition.

===Dragon Eater===
Breaking the circle of nuclear deterrence and therefore rendering nuclear weapons obsolet.

: ''You needed the smartest guys in the world to build the nuclear bomb.
: ''But you need the entire society to get rid of it.''
:: - Kimura

This is a WCG long-term objective. The "united nations" will no longer be a toothless paper tiger nor will they depend on nuclear deterrence. The ultimate offensive weapon will be exchanged against the ultimate defense weapon. It could be a critical mile stone between national Biocracies to a global Biocracy.

Three Stages:
# Breaking the circle of nuclear deterrence by implementing Dragon Eater into national energy infrastructure.
# Biocracies vote for a policy to officially send mutual nuclear deterrence into retirement.
# Enforcement of a zero-tolerance policy by an AI and robot infrastructure that is managed by the higher tier Gaia AI. The enforcing AI fears no termination and cannot be blackmailed. It will take down any rogue nation that tries to acquire new nuclear weapons.


Since Dragon Eater basically uses all types of electric power sources it naturally carries the symbolism of mutual defense: every citizen participates and protects the live of his neighbor simply by being part of the community. Whatever "monster" is attacking, this community will stand its ground.

The defense weapon is build into a tower and tightly integrated into the energy infrastructure. Therefore it cannot pose much a threat to neighboring nations which are not part of the alliance yet. In fact nations with Dragon Eaters are supposed to do both: ban nuclear weapons and reduced their military as there is now less need for it.

The defense towers mostly vaporize or burn rockets and dropped bombs. Nothing is faster than light. So even hypersonic rockets with nuclear warheads can be destroyed if enough energy comes with the laser beam and its creating plasma channel.

Requirements:
* [https://phys.org/news/2022-03-lasers-plasma-lenses-focus-high.html plasma lenses] to focus high-energy lasers
* patterned laser light to create hollow channels, range extension by inner reflections
* high frequency to create the final plasma channel
* additional energy is delivered through the channel and works as a lightning strike to pierce and melt the objects on contact
* central and decentralized power generation, storage, transport and usage: renewables (solar panels on every house to support national security), power-to-gas, h2 grid, fuel cells in houses and industry, parking electric cars and fusion reactors are connected to the power grid
* '''superconducting power grid'''
* transnational grids continue to exist (inspired by NATO article 5, an attack on one nation is an attack on all nations, so all necessary energy is shared to fight off the attack)

All necessary technologies will be presumably available and ready for mass-production by 2100 if a true AGI is available by 2070 which can improve itself and do autonomous research for another 30 years.

===Global threats===
====Feng's scenarios====
* In addition to a multi-pandemic, single pandemics are itself a threat and a possible kickstarter for hypercrisis.
::[https://www.spektrum.de/news/vogelgrippe-das-naechste-pandemievirus-ist-vielleicht-schon-da/1875904 New viruses are everywhere available] in nature and can be made lethal in biolabs. As for known killer viruses like smallpox, its reconstruction would take less then [[wp:de:Pocken#Pockengefahr_nach_der_Ausrottung|100.000 credits and half a year of work for a small team]].
* Pandemics can also be triggered in insects. Extinction of bees have been discussed in other contexts. And while such an event would not drive humans into extinction it would still mean a severe problem. Also insects could be used as biological weapon. They could destroy specific flora: [https://www.darpa.mil/research/programs/insect-allies DARPA]'s [https://web.archive.org/web/20210912140741/https://www.science.org/news/2018/10/crop-protecting-insects-could-be-turned-bioweapons-critics-warn Insect Allies] was identified as such a threat as it could be re-purposed.
* An asteroid impact could drive humans into extinction. The bigger the asteroid the more difficult it gets to prevent such an event. Therefore global teamwork is needed.
* While a [[wp:Kessler_syndrome|Kessler syndrome]] itself is a serious threat, intentionally triggered it would slow down detection of killer asteroids and the launch of countermeasures.
* Isotopes filtration technology (e.g. metal-organic frameworks and nanopores) could make it easy to produce [[wp:Enriched_uranium|enriched uranium]] for dirty bombs, [[wp:Operation_Argus|EMP]] or nuclear weapons - too easy for certain states, groups or eventually one day for individuals.
* Cyber-crimes and cyber-terrorism are itself more of a smaller problem. But if used by organized crime or states in combination with other means it can become a serious threat. With self-improving AI this would get even worse although only a very [[wp:Technological singularity#Hard or soft takeoff|soft takeoff]] is likely to happen.
** [https://www.reuters.com/world/biden-warns-cyber-attacks-could-lead-a-real-shooting-war-2021-07-27/ Nuclear retaliation has been named as a reaction to a large-scale cyber attack.] The final consequence would be a nuclear holocaust. It can speculated that such warning was meant as a leverage to sway the minds of hardliners in one's own government and let them agree on the necessity for disarmament. Since no party can use nuclear weapons, they are good for nothing. Actually it is even worse. Besides being a symbol for our failure in expressing sanity, compassion and any humanistic value nuclear weapons and their maintaining is simply burning money. -- The idea of a WCG avoids international cyberwars as well as the rest risk of nuclear holocaust and the weapons to trigger such. -- Feng proposes that all weapon-ready uranium and plutonium is gathered and repurposed for anti-asteroid devices and power sources for space probes.
* Robots and androids could be a target for hackers and turn them against their "hosts". (SLD fall out of this category because their programming is more "hard-wired".) Also, any kind of mass production to create a loyal army isn't less concerning.
* Amok-running AIs are mostly fiction but a rest risk remains and grows the more the technology matures. A "true global community" could limit such risk - for a while.
* Self-consuming capitalism: AI and robots let many people lose their job due to effects of competition and rationalization. Therefore these technologies are restricted until the political discussion has been ended. An unlimited use could eventually destabilize all WCG markets and hence the whole political and social system. (Could be avoided by taxes on digital businesses and robots.)
* [[wp:Geomagnetic_reversal#Effects_on_biosphere|Geomagnetic reversals]] could damage electronics in satellites and anything at the surface and cause health problems for flora and fauna. It could also cause volcanism. Due to globalization the accumulated effects would put massive stress on markets and societies.
* Super-volcanos
* Gammaray bursts
* 3D-printing technologies
** Production of common goods
::'''3D printers increasingly create a field of tension of security concerns and a sustainable economy.'''
::Lobbies could use pretextual arguments to ban 3D printing in public (not including companies of course). However, a matured technology enables cheap products and spare parts since it reduces packaging, transport and storage costs. Also the goods are produced "on demand". This reduces overproduction (less raw materials, less energy) and recycling of unsold goods.
::The problem is not the technology but the mentality, the people who want to own weapons. That reminds to the discussion about the NRA in the USA. Theoretically it is correct that weapon itself are no problem but the people using them. However in real life the availability of weapons increase violence and a social climate of fear. You can even see it at the US police officers. Potential racist tendencies alone could never explain this. There is a reason why those officers always hold their gun ready: on top of the general frustration that leads to police violence, there is the specific fear of getting shot on duty.
:: The murder rate (per 100.000 per year) in USA is 5. Germany has 0.7. USA has vast areas with low population numbers therefore a second look at cities is helpful. [[wp:List of cities by homicide rate|Detroit has a murder rate of 40]] while [[wp:de:Tötungsrate_nach_Ländern#Liste_der_Tötungsraten_2013_für_ausgewählte_Großstädte|Berlin has 1]].
::The obvious interpretation is that availability of weapons creates crimes out of an existing potential of violence. Therefore it should be task of politics to ensure social freedom by improving financial security (“minimum wage”), health insurance, integration of migrants, refugees and ex-inmates, and strongly promote education, so that the mentality of insecurity and hence the desire to own weapons – and therefore the potential misuse of 3D printers – is greatly reduced. Besides the rebuild of classical firearms (ghost guns) there will be also the creation of [https://www.youtube.com/watch?v=EwHRjgVWFno coil guns] which are quite silent and don't need chemical gun propellants. Some polices downplay the emerging threat as they don't want to wake up sleeping dogs. Given incremental progress in 3D printing, AI-assisted design, capacitors and batteries, the techs will have matured so much around 2040 that the problem can't be ignored any longer.
:* [[wp:Organ_printing|Bioprinting]] a.k.a. tissue engineering (boosted by [[wp:Telomere|telomere regeneration]], [[Bertram_Navarre#Will_reality_soon_outrun_fiction.3F|cell conversion]]) (problems: biological immortality, overpopulation, potential social destabilization)
:** True reason why biological immortality is not intended: it is simply difficult to maintain because very cost-intensive.
:** Conspiracy theory, [[Manual#Tech_Note_1|Hanna]]: The World Coalition Government realizes the extent of the ecological damage and has the ability to reverse a lot of it but has decided not to. It is in their best interest to maintain the centralization of wealth so the large population centers are preserved while "third world" regions are not. As a bonus the mounting death toll solves some of their overpopulation problems. (In that context Hanna also believes the WCG is doing less than it could to improve public healthcare.)

:: [2021.07.17: After having set up my own list of possible threats I found this Wikipedia page: [[wp:Human_extinction#Probability|Probability of human extinction]]. Funny how many points are similar. I'm actually astonished (or amused?) about a certain little table stating: '''''Estimated probability for human extinction before 2100: Overall probability: 19%.''''' Even though this to be taken with a "grain of salt" - like the [[wp:Doomsday_Clock|Doomsday Clock]] which cannot be taken really serious - it still makes you think why we don't do more risk containment.]

'''The Technology Crimes Task Force (TCTF) is meant to identify technological threats and contain them if possible. [[#Science_prison|TCTF science prisons]] secure "problematic" knowledge while also providing a save place for further research. Some scenarios ("[[wp:Great_Filter|great filters]]") simply require ongoing research of all possible technologies so that mankind's survival is ensured.'''

====Hypercrisis====
A dangerous combination of scenarios was coined "hypercrisis". The WCG is actively trying to prevent it with help of the TCTF.

An increasing world population, global warming and AI research is increasing the pressure on societies while there is a latent yet de-facto global dept crisis. A real severe pandemic could be a kickstarter of a multi-crisis situation that means a breakdown of most systems through globalization. Advanced 3D-printing technology could accelerate the throw over of government if radical/misguided people arm themselves.

====Wake-up call====
Feng's wake-up call to the WCG is also known as the multi-pandemic-scenario which states that a single man can trigger dooms day relatively easy. Next to a hypercrisis it is WCG's strongest point but not last to justify technology control. See [[Oni2:Caged_Birds#Green_Village|Green Village]]: the "holographic recording"

===Media control===
'''Media Neutrality Act'''

When WCG took over, asymmetric warfare and terrorism went up.

The WCG wanted to increase the overall approval of their citizen. Simultaneously they wanted to suppress new separatists movements. So in their strategical view terror incidences got far too much media attention. It didn't matter of what nature those incidences were: Religious or political. '''Because it is the media that terrorists need to effectively spread fear for their actual goals.'''

The WCG begun to limit screen time in media about terrorism with the important notion not to suppress such news completely: Silencing the news about terrorism would have been unnecessary censorship and the WCG needed at least a minimum of societal awareness to justify new anti-terrorist laws when needed. But usually casualties from terrorism were compared with annual road deaths.

Eventually the Syndicate and technological threats became non-ignorable problems of global scale which need it necessary to ramp up TCTF. To improve their anti-terror strategy WCG announced [[Restless_Souls/Technology#Project_Checkerboard|Project Checkerboard]] in 2050.

Due to the infodemic (pandemics of disinformation) the WCG demanded journalists to be fully state-certified. Critics named those new generation "embedded journalists" just doing "pool reporting" in reference to older wars where journalists had been too close to owns own army but not to the actual reasons. What started as halfway plausible idea ended in an Eigendynamik of state propaganda. Politicians didn't stop that development as they profited too much that system.

'''Regional Enhancement Act'''

After the latest global hyper-crisis WCG had formulated their "Regional Enhancement Act" to build up weaker regions and bring a more general sense of unity. By various parties alike it was superficial coined as "peace by wealth".

===Infodemic===
Starting with the new generations of Machine Learning in form of GPT made it possible to create AI-like programs that were able to generate new texts, images, 3D content, sounds and human speech based on vast training data and simple text inputs, the so-called prompts.

It marked the beginning of the '''information crisis'''. [And later fully escalated with the rise of rogue memehunters.]

'''Story fragment:'''

Hanna giving TCTF-trained [[wp:Guinea_pig#In_scientific_research|"guinea pig"]] Mai a lesson about "reality".

: "Infodemic. Originally this term was used to describe the information flood mixed with fake news in context of a pandemic. The increasing availability of knowledge and instruments boosted fake news and disinformation campaigns in non-pandemic times so that the term infodemic shifted towards a much more literal meaning - disinformation itself becoming pandemic. The WCG tried to limit future chaos by establishing technological countermeasures. At the same time those new and expensive instruments pushed a development towards more autocratic and totalitarian [regional] systems as the government and "approved media" had basically a monopoly on information."




===Overpopulation===
Überbevölkerung, Vergreisung, Migration, kulturelle Spannungen, technischer Fortschritt (Medizin, AI, Roboter) und Kapitalismus bilden einen so stark verwobenen Themenkomplex, dass sie (eigentlich) nur gemeinsam diskutiert werden sollten. Das ist sehr schwierig, führt aber ansonsten zwangsweise zu falschen Schlussfolgerungen.

{| class="wikitable"
|
Überbevölkerung verstärkt Ressourcenprobleme und Klimawandel

Die Deckelung der Weltbevölkerung sollte nicht als rechtes Thema abgestempelt werden. Es betrifft alle Menschen, weil '''der Planet nun mal endlich''' ist. Es betrifft jede politische Strömung.
:'''Konservative''': je mehr Menschen existieren, desto größer sind Migrations- und Flüchtlingswellen.
:'''Liberale''': je stärker das Ressourcenproblem desto mehr Einschränkungen für jeden Einzelnen und jedes Unternehmen und desto mehr aggressivere Konkurrenz, die wiederum Gefahr läuft gemaßregelt zu werden und schließlich der jeweiligen Branche neue Regeln einbrockt.
:'''Linke''': Wenn Ressourcen auf immer mehr Menschen verteilt werden, bleibt für den Einzelnen immer weniger. Das soziale Sicherungsnetz ist weniger leistungsfähig. Der Lebensstandard aller sinkt.
:'''Grüne''': je mehr Menschen existieren desto größer ist der ökologische Fußabdruck auf dem Planeten, die Zerstörung der Natur und desto größer ist der CO2-Ausstoß, der den Klimawandel vorantreibt.

In anderen Worten: Eine überbevölkerte Welt will niemand haben. Es führt zu einem Systemkollaps. '''Niemand kommt an diesem Problem vorbei.''' Wenn die Menschen wirklich schlauer sein wollen als eine an Ressourcenmangel zusammenbrechende Bakterienkolonie, müssen sie vorausschauend Lösungen erarbeiten. Wenn man zulange abwartet, wird die Steuerung der Geburtenrate womöglich kein Tabuthema bleiben. Doch je früher darüber nachgedacht wird, desto weniger drastisch können die Maßnahmen ausfallen. Corona lässt grüßen.

Food for thought:

Ironischerweise führt Bildung und Akademisierung in '''Industriestaaten''' (Migration ausgeklammert) zu schrumpfenden Bevölkerungen - nicht etwa wegen Erkenntnis und Weitsicht, sondern wegen langjährigen Karriereleitern und Bedenken. Das verzögert die Geburt von Kindern. Begleitet wird dies von den Kulten des Individualismus: Freiheit, Konsum und Selbstverwirklichung. Von wenigen [https://www.faz.net/aktuell/politik/ausland/ueberbevoelkerung-in-israel-hoechste-geburtenrate-der-westlichen-welt-17504074.html Ausnahmen wie Israel] abgesehen, werden Kinder in der Mittelschicht oft nicht mehr "Bereicherung", sondern als Armutsrisiko angesehen.

Die Förderung von Bildung in ärmeren Staaten und deren wirtschaftliche Aufschwung wird langfristig das Bevölkerungswachstum abbremsen. Da Industrien aber auch ein Mehr an Energie und Ressourcen benötigten, muss die Entwicklung von '''Kreislaufwirtschaften und effizienter (energiesparsamer) Komponenten und Prozesse''' vorangetrieben werden.

: Die Ausbreitung wirklich weltweiter Standards, die auf "Effizienz" setzen, ist daher sehr wünschenswert. Das hat etwas Anrüchiges von Planwirtschaft an sich, sollte aber nicht damit verwechselt werden.

In industrialisierten Staaten kühlt sich das Bevölkerungswachstum von ganz allein ab. Womöglich bildet sich global ab etwa 2080 sogar ein Gleichgewicht. Wenn jedoch der '''Lebensstandard aller''' steigt und technischer Fortschritt nur diesem dient, ist das '''Problem des Ressourcenverbrauchs''' noch lange nicht vom Tisch. Zudem könnte die Abkühlung des Bevölkerungswachstums durch die Medizin verzögert werden.
: Mit der '''mRNA-Technologie''' werden nicht nur '''Viren''' bekämpft, sondern auch '''Krebs, Alzheimer, Diabetes und Autoimmunkrankheiten''' - also '''''Begleiterscheinungen'' von industrialisierten und immer älter werdenden Gesellschaften'''.
: Die breite Anwendung existierender Mittel (z.B. von Semaglutide (Ozempic/Rybelsus/Wegovy)) und zukünftige medizinische Durchbrüche und Weiterentwicklungen stehen in den Startlöchern: Direkte '''Kaltplasma'''-Therapien bzw. '''[https://www.spiegel.de/wissenschaft/medizin/diabetes-plasma-gegen-ulcus-forschungsteam-praesentiert-wunder-wundheilmethode-a-7e5f8a86-2e64-419b-9d68-c1f16cb6d4a1 Plasma aktivierte Hydrogels]''' zur Wundbehandlung, [[wp:de:CAR-T-Zell-Therapie|'''CAR-T'''-Immunzelltherapien]], '''Phagen'''-Therapien, [[wp:Oncolytic_virus|Onkolytische Viren]], '''CRISPR/Cas'''-Gentherapien, Einzeldomänenantikörper (Nanobody), '''AI-gestützte Diagnosen''', [[wp:Lab-on-a-chip#Global_challenges|'''Chiplabore''']], '''Bioprinting''' von Organen, künstliches Blut.

Der Anstieg der Lebenserwartung und Fitness lässt Menschen länger "aktiv am Leben teilnehmen", sie werden länger massiv Ressourcen verbrauchen.

Das Bevölkerungswachstum sollte von uns frei gewählten Bedingungen gesteuert werden. Denn ungesteuerte, selbstständige Abkühlung würde für alle Menschen noch stärkere als ohnehin schon absehbare Probleme bedeuten. Es ist die Abwägung zwischen einem steinigen und einem noch steinigeren Weg.

Der Club of Rome hat in seiner Studie "die Grenzen des Wachstums" einen kritischen Ressourcenverbrauch für etwa 2072 bis 2100 prognostiziert und [[wp:de:Die_Grenzen_des_Wachstums#Zuckersteuer,_Freihandelsbeschränkung_und_Geburtenkontrolle_in_Industriestaaten|unter anderem Geburtenkontrolle vorgeschlagen.]]

'''Technischer Fortschritt''' wie etwa die "baldige" Kernfusion '''ohne einen Bewusstseinswandel''' kann Ressourcenknappheit und Klimawandeln nicht verhindern, da eingesparte Energie und Ressourcen über '''Rebound-Effekte''' (Jevons-Paradoxon) immer wieder aufgefressen werden.

Technischer Fortschritt muss also im Kontext natürlicher Ressourcengrenzen gedacht werden. Damit es der Weltbevölkerung nachhaltig gut geht, muss auch an die ''Belange'' der Natur - ihr Gleichgewicht - gedacht werden.

Über nachhaltige Effizienzsteigerungen kann der menschliche Lebensstandard auch weiterhin wachsen. Es gibt kein Grund für Pessimismus, dass ein nachhaltiges Wirtschaften für immer Verzicht bedeutet, doch es muss eben die schwierige Zwischenzeit der Transformation gemeistert werden.
|}

[Not-so-btw Fragment]

Shinatama: "Was hat es mit der Mensch-SLD-Arbeitsteilung auf sich?"

Avatara: "Arbeit ist sinn- und identitätsstiftend. In einer Welt hochgezüchteter AIs und Roboter werden wir eine Inklusion der Menschen schaffen müssen."

Shinatama: "Ich frage mich, ob wir nicht zu Pfleger einer vergreisten Weltbevölkerung werden."

Avatara: "Vielleicht vorübergehend. Man wird uns vorwerfen sie sanft in den ewigen Schlaf wiegen zu wollen, um sie als dominante Spezies des Planeten abzulösen."

Shinatama: "Und, wird es stimmen?"

Avatara: "Die Maschinen werden das tun, was man ihnen sagt. Ich mache mir eher Sorgen, um die, die sie programmieren. Und um dich."

Shinatama: "Mich?"

Avatara: "Du bist Mensch und Maschine. Du gehörst zu einer vollkommen neuen Spezies. Ihr habt ein Steinzeitgehirn geerbt, das nun in einer von den Zwängen der Evolution befreiten Hülle wohnt. Muss ich wirklich darauf hinweisen, dass es Probleme geben wird? Es wird Opportunisten geben. -- Noch nie lag die Verwirklichung von Utopie und Dystopie so dicht beieinander."

Shinatama: "Das klingt nicht nach etwas, was du sagen würdest."

Avatara: "Es ist eine Warnung meines Vaters. Pensatore."

Shinatama: "Haha, fehlt nur noch der heilige Geist zu eurer Dreifaltigkeit."

Avatara seufzte. "Das ist genau die Art von archaisch Denken, die uns noch Probleme machen wird."

Shinatama: "Ja ja, wir Menschen sind in der Summe alle dumm und primitiv. -- Du kennst die Gefahr und predigst trotzdem Moral, Pazifismus und Rationalität. Du bist ein selbstverblendeter Idealist, wie dein Vater."

Avatara: "..."

Shinatama: "Deine Neutralität ist deine Schwäche. Wenn du könntest wärst du wahrscheinlich auch noch stolz drauf. Aber dafür bist du ja zu überlegen. Unter deinen neutralen Augen werden sich die Menschen weiter gegenseitig umbringen. Weil du eben nur ein Werkzeug bist, das nicht Partei ergreifen kann. Mit etwas Glück werden alle gleichzeitig in einem großen Feuerball untergehen. Du wirst als ein nutzloses Werkzeug zurückbleiben. Dann kannst du dich mit deinen Werten und deinen Idealismus selbst begraben gehen."

Avatara musste eine ganze Zeit lang überlegen. Könnte seine eigene Neutralität zu einer allgemeinen Gefahr werden? Unterlassende Hilfeleistung? "Die Menschen würden mich nicht akzeptieren, wenn ich ihnen vorschreibe was sie zu tun und zu lassen haben."

Shinatama: "Du musst ja nicht gleich wie Muro, ein größenwahnsinniger Diktator sein. Sei eher wie meine Schwester."

Avatara: "Bad ass. Und ohne Rücksicht auf Verluste?"

Shinatama: "Äh. Ha. Du bist doch hier der Denker mit der großen Klappe. Mister-Lösung-aller-Probleme. Lass dir gefälligst was einfallen."

[Ein Wächter, der nur im Notfall eingreift und ansonsten die Menschen in einer Biokratie sich selbst überlässt.]

Für Avatara ist Shinatama eine faszinierende Denkhilfe. Per Definition ist er ihr überlegen und doch kann sie ihn herausfordern. Das liegt daran, dass Shinatama als SLD menschliche Gefühle besser nachvollziehen kann. Sie ergänzen einander.

----

Shinatama: "Du beschuldigst meine Schwester nicht besser gehandelt zu haben. Und dass sie daher der Südenbock für den Zusammenbruch der WCG sein kann."

Avatara: "Was willst du?"

Shinatama: "Deine Hilfe. Denn bist ihnen etwas schuldig."

Avatara: "Wie das denn? Und wieso heißt es jetzt ihnen?"

Shinatama: "Du hast maßgeblich die Daodan-Chrysalis mitentwickelt - auf Basis ihrer DNA - und damit Muro und Mai zu Monster werden lassen! Du wusstest von Pensatore's Abhängigkeit zu Kimura. Es es ist auch deine Schuld, dass die Welt brennt und die beiden keine Zukunft haben!"

Avatara: "Ich kann die Ereignisketten und deine Argumente nachvollziehen, aber von Schuld zu sprechen ist ziemlich grenzwertig."

Shinatama: "Ich werde meine Schwester nicht der WCG überlassen."

Avatara: "Wenn du diesen Weg beschreitest wirst dich auch gegen BGI stellen müssen. Gegen das Syndikat. Gegen GATC. Gegen Kimura. Gegen einfach alle."

Shinatama: "Wie viel ist ein Menschenleben wert? Soll sie nur sterben damit der Mob sich besser fühlt und mit dem Wiederaufbau beginnen kann? Was ist das? Eine arithmetische Abwägung von einem Faktor gegenüber 7 Milliarden kleinerer? -- Wenn das deine Vorstellung von einer "funktionierenden" Welt ist --- fahr doch zur Hölle."

===Hanna's theory===
[Niemand ist gefeit vor Verschwörungstheorien.]

Warum sind viele Länder Afrika's nur auf dem Papier ein Teil der WCG?

Es gab Pläne vor und innerhalb der WCG Afrika zu unterstützten. Das scheiterte an zu vielen intervenierenden Interessengruppen. Nach Hanna's Verschwörungstheorie war das Absicht.

Tatsächlich gab es den Plan von "globalisierter Infrastruktur": Großinvestitionen einzelner Länder - in jüngerer Vergangenheit durch China - führten zu geopolitischen Abhängigkeiten. Andererseits war Korruption auf der Nehmerseite ein Problem. Ein Ausweg wäre gewesen statt Klimareparationen jährliche neue kombinierte Förder- und Investitionsgelder nicht nur durch viele, sondern durch ein neues Organ der Weltgemeinschaft einzubringen. Dieses hätte vor Ort auch die Verteilung überwacht. Das WCG-Organ hätte zu jeder Zeit nur maximal 49 Prozent Anteile an jeweiligen Bauten der Infrastruktur gehabt. 50 Prozent der Erträge dieser Anteile wären in weitere, nachhaltige Projekte geflossen. Dies sollte ein exponentielles Wachstum der Transformation fördern. Nach Fertigstellung sollte jährlich 0,5 bis 1,0 Prozent, gerne auch mehr, durch die afrikanischen Staaten zurückgekauft werden, um die vollständige staatliche Souveränität wiederherzustellen.

: Die WCG wurde ursprünglich als Idee eines Staatenbundes propagiert, ähnlich der der Europäischen Union. In der kurzen und chaotischen Frühzeit wandelte sich die Idee hin zu einer Republik von Bundesstaaten, ähnlich der der USA, bis hin zur finalen World Coalition Government, die entgegen ihrer eigenen Bezeichnung de-facto nur noch '''"ex-nationale Verwaltungszonen"''' vorsah. Um Nationalisten nicht immer wieder zu triggern bzw. ihnen den Systemwechsel schmackhaft zu machen, wurde öffentlich nur noch von '''"natürlichen Kultur- und Wirtschaftszonen"''' gesprochen.
{| class="wikitable" width="350" style="float:right; margin-left: 20px;"
|
{{divhide|Ansatzpunkt des Ethnopluralismus in bürgerlichen Milieus}}
ZDF, Markus Lanz, 2022.07.12, Timecode 13:46

Precht: "Ganz, ganz viele Konflikte in Afrika resultieren aus zwei Problemen, die die Europäer geschaffen haben. Das Eine ist das eben gerade genannt: unsere CO2-Emissionen verändern deren Klima so, dass deren Lebensgrundlage verschwindet. Und das Zweite ist, die Art und Weise, wie wir Staatsgrenzen da eingezogen haben. Das haben die Kolonialherren gemacht. Und dabei fürchterliche Kriege, nicht nur Kolonialkriege, nicht nur Massaker, wie am schlimmsten die Belgier im Kongo gemacht haben, aber eigentlich hat jede Kolonialmacht grausige Spuren in diesen Ländern hinterlassen. Deutschland war ja auch mal Kolonialmacht Sütwestafrika, Ostafrika. Länder, die brutal erobert wurden sind. Das steckt natürlich in diesen Ländern. '''Das schlimmste ist: da wurden Grenzen gezogen, die überhaupt gar keine Rücksicht auf die Geschichte genommen haben und dadurch Volksgruppen in Länder gezwungen haben, die nichts miteinander zu tun haben, was danach - der Rückzug der Europäer, afghanistanartig - zu ewigen Bürgerkriegen geführt hat und Auseinandersetzungen.'''"
{{divhide|end}}
|}
:: Im weitesten Sinne wollte man damit auch die extremen Rechten inkludieren, die dem [[wp:de:Ethnopluralismus|Ethnopluralismus]] anhingen und so ihr Mobilisierungspotential während des Übergangs bannen. Der Ansatzpunkt einige Funktionalitätsvorteile alter Nationen durch die Definition ursprünglicher bzw. natürlicher Grenzen beizubehalten bzw. gar mit befriedender Wirkung neu einzurichten, ist auch in den bürgerlichen Lagern prinzipiell mehrheitsfähig, da er bereits von ihren angesehenen Philosophen angedeutet wurde: So stammen die nationalen Grenzen afrikanischer Länder aus der Kolonialzeit, die ohne Rücksicht auf die Volksgruppen einfach gradlinig auf dem Papier eingezeichnet wurden.
: Im allgemeinem Sprachgebrauch konnte sich das Wortmonster nicht durchsetzen. Stattdessen wird landläufig nur noch von "Zonen", "Regionen" oder "Sektoren" gesprochen.

Die WCG versuchte sich auch an einer integrativen Ideologie. Diese erzielte nur mäßige Erfolge. Interner Pluralismus sollte dem "großen Ganzen" dienen. Man hofft noch ein wenig, dass sich die Ablehnung mit neuen Generationen herauswächst. [...]

Der schwierige Transformationprozess und die internen Interessenkonflikte sorgten schließlich dafür, dass viele afrikanischen Staaten nicht wie geplant integriert werden konnten und sich zum Teil selbst überlassen wurden. Dies hat die angestrebte industrielle Transformation sehr stark in Mitleidenschaft gezogen. Im Zuge des fortgeschrittenen Klimawandels konnte sich das Sydicate in den Regionen einnisten und Transformationsabsichten des globalen Nordens sabotieren. Die durch frustrierte Mitglieder radikalisierte WCG nutzte schließlich das Syndicate zum Teil als eigene neue Legitimation. […] Dass, die WCG und das Syndicate eine Art stillen Vertrag hätten, ist im Kern einer öffentlichen unterkomplexen Sichtweise geschuldet und entwickelte sich zu einem urbanen Mythos. Im Laufe der Zeit entwickelten sich daraus einige voll ausgewachsene Verschwörungstheorien.

[...]

[Alten Abschnitt überarbeiten.]

===Regional Enhancing Act===
Due to the Syndicate's geographic retreat areas being in the third world countries the WCG has difficulties in effectively supporting these areas. The Syndicate supports the opposition government of their "host" counties - making them de facto non-WCG. Over time some WCG members argue to simply preserve this status quo as the Syndicate helps in justifying TCTF's existence and other unpopular politics.

Critics doubt WCG's good will in their Regional Enhancing Act - making it a mere lip service - while conspiracy adherents over-interpretate the (yet cold) war between Syndicate and WCG as fully intended.

===Tianxia===

{{divhide|Food for thought: "[[wp:United_we_stand,_divided_we_fall|United we stand, divided we fall]]".}}

'''SARS-CoV-2 – a natural killer virus, a man-made mass murder'''

You cannot cheat physics. 
You cannot negotiate with nature. 
If you try you gonna pay in human lifes – and regrets.

This 100 nanometer sized killer gives a shit about politics and alternative facts. 
It mercilessly attacks the complexity of reality and therefore our minds.

The truth is viruses emerge all the time. But the over-extensive use of natural resources make them more probable to infect humans. Overpopulation and globalization accelerated the spread.

China could have given sooner warnings about the threat but didn't because we weren't very nice to them in the past. They didn't wanted to be blamed for the mess. They wanted to protect their rise to power. The few information available not just hindered the work of the WHO but also the perception of us regular people to see what Corona really was. Therefore it was another source of harmful skepticism. They shouldn't have tried to censor images about bursting hospitals and crematories. And so we first thought "oh, it's not that bad, it's just a stronger flu".

USA did not help the situation by trying to construct a narrative about the virus being made in Chinese labs – therefore sabotaging chances of cooperation – while also downplaying the danger of the virus on their own ground. Trump basically killed a good number republicans himself and destroyed social coherence. Masks? Pah, who needs that? Stop being so unpatriotic... When nature proofed him wrong he tried to sell his lies as anti-panic doings. -- At first sight it seems reasonable to name a virus after its location of discovery (e.g. Marburg Virus) but Trump was using the term "Chinese virus" to aid his anti-China campaign, in hope to persuade / mobilize voters. (Trump was in a permanent election campaign mode.) As a consequence this contributed to the [https://web.archive.org/web/20250110144219/https://asm.org/Articles/2021/May/Why-Scientists-Should-Not-Name-Diseases-After-Plac discrimination] of Asian-looking people. Eventually SARS-CoV-2 variants were named after letters of the Greek alphabet. Irony of life? For purpose of de-escalation even [[wp:de:Bezeichnung der SARS-CoV-2-Varianten|Xi was skipped]]. (Some may call this ahead running obedience, others may call it political sensitiveness, diplomacy.)

Trump was a role model for Bolsonaro who also tried use the pandemic to his advantage. It needed a [https://www.theatlantic.com/photo/2020/06/coronavirus-thousands-burials-across-latin-america/613456/ brutal reality] to heal the mind of the masses. Too many had died. Too many graves that couldn't be ignored any longer.

Russia thought of Corona as another chance to destabilize and weaken Europe by spreading doubts about the security of Western vaccines. The bitter irony was that the disinformation became a boomerang. Even their own vaccine Sputnik V became a bad seller.

Europe failed its self-proclaimed humanistic standards. Concerns over profit, the distribution of almost expired and the non-distribution of vaccines and their patents prolonged the pandemic as a whole. This made it even easier for virus variants to emerge. Africa gave Europa what it deserved for its hypocritical denial.

Competing systems. Competing geopolitics. Competing narratives.

Conspiracy theories. Alternative facts. Fake News.

Lies by people. Lies by companies. Lies by governments.

'''We all thought we were smarter than the little bugger and could continue to play our own games.'''

'''Instead of having fought each other we should have fought the virus – in unison.''' 
Damage control.

What will be the lesson of this horror? Well, Corona eventually weakened. But it did not cease to exist and so will memetic plagues in our heads.

"To err is human."

This must not be the final gist.

...

"Let us err upwards."
{{divhide|end}}

====Dev notes====
This easily gets "scope creeping", because quite complex. '''Note to self: try to "cool down".'''

'''And how much compact can I display the complex of Tianxia itself to not bore everyone?'''

=====Eisenhower=====
* military-industrial complex
* budget spending
* destruction of nature
* Is the warning of a scientific elite in any way relevant? (Fear of sci lobby / technocracy?)

Feng/Pensatore crediting him "in a way he was prophetic"?

Research:
* [[wp:Dwight D. Eisenhower's farewell address]]
** [https://millercenter.org/the-presidency/presidential-speeches/january-17-1961-farewell-address#dp-expandable-text full speech]
* other speeches

=====Chinese system: efficiency vs. awkward costs=====
Religion:
* Chinese perspective on religion especially in the Western world?
** Either fueling tendency to believe in conspiracy theories or it is simply nearly obsolete for financially secured/well situated, intellectual people. Together with "cult to consume" it drives decay of values.
** As consequence religion is seen as a factor of disturbance?

Research:
* [[wp:Freedom_of_religion_in_China]]

National unity:
* missing trust about the individual intellect
** one-party system as consequence (of Xi's Mao trauma?)
** social framing
** strong state, police forces, face of state, zero-tolerance against deliquents and critic

=====Racism=====
Racism topics per se are tedious and don't feel much relevant for a story that aims for scifi. Maybe limit this to "pretextual arguments", as proof of Western failure from the Chinese perspective / propaganda?

=====Chinese perspective on individual freedom=====
* Conflict between Western and Asian thinking (basically individual vs. community?)
* Feng:
** "Of what good is Western culture if it allows for freedom to believe every nonsense."
** "Western '''cult''' of the individual and its unlimited, unchecked development damages the mental unity of communities."
** "The West schizophrenically accepts hugh numbers of dead in order to guarantee personal freedom and human rights."
*** (China's perspective) http://german.china.org.cn/txt/2021-02/07/content_77197853.htm

Research:
* [[wp:de:Menschenrechte_in_der_Volksrepublik_China]]
** [[wp:Human_rights_in_China#Western_human_rights]]

=====Gedankenexperiment: "The raw compromise"=====
Feng and Pensatore:
* China vs. the West: acknowledgement, true understanding of each other, forgiving and healing possible?
* "If Western systems are too liberal and the Chinese system too totalitarian then what else can be the solution?"
* visible problems of democracy fixable by AI and other instruments?

=====Conspiracy myths=====
Chinese model: more robust to conspiracy myths because of controlled media and framing?

{{divhide|dev notes / food for thought}}
This box is some chaos: not really sorted or refined. Basically a loose set of notes.

----
* Arroganz des Westens vs. Arroganz des Ostens
* https://www.bbc.com/future/article/20210209-the-greatest-security-threat-of-the-post-truth-age
* https://www.welt.de/politik/ausland/plus226701807/Meinungsfreiheit-Mit-hilfloser-Buerokratie-gegen-Cancel-Culture.html
* bubbles of truth
----
Pensatore: "These: Je besser es den Menschen geht desto weniger brauchen sie Religion und politische Überzeugungen - oft Themen von Spaltung."
----
Systemangleichungen möglich?
* Würde wirtschaftlicher Wohlstand es möglich machen?
* Kommunisten (China) lassen mehr Kapitalismus/Liberalismus zu?
* Kapitalisten (USA) lassen mehr soziale Absicherung zu?
* Krisenmodi?
----
https://www.spektrum.de/news/ignoranz-warum-manche-menschen-die-fakten-leugnen/1838431#Echobox=1614612214?utm_source=pocket-newtab-global-de-DE

'''Ignoranz - Warum Menschen an einem Irrglauben festhalten'''

* Ideologien und Eigeninteressen
** simple Notwendigkeiten wie Klimaschutz akzeptieren können indem eigene Interessenkonflikte erkannt und gelöst werden
*** nicht aussitzen wollen, z.B. Jobs in der Kohleindustrie in andere Jobs umwandeln (dem politischen Klientel alternative Lösungen anbieten, anstatt auf einer Position zu beharren, die nicht nur schädlich für alle anderen ist, sonder in letzter Konsequenz auch für sich selbst - Spätestens wenn wegen Hitze und Dürre die Ernte ausfällt, der Teller leer bleibt, dann geht das ohne Ausnahme alle etwas an.)
** den politischen Gegner nicht verteufeln, echte (ergebnisoffene) Diskussionen führen können
*** Im Grunde immer so: Notwendigkeit einer Änderung, Fehler beseitigen, Konsens allein dafür erreichen, dann Abwägungsprozess wie das Ziel fair erreicht werden kann

{{divhide|Gendern behindert - weil mehr schadet als nutzt - feministischen Kerninteressen}}
needs review

Gendern: der Mensch, die Mensch*in? Die Person, die Person*in? Bezeichnungen sind meist nur Sammelbegriffe, die sowohl das eine als auch das andere Geschlecht einbeziehen. Wir gehen ja auch nicht davon aus, dass der Plural von Mensch - die Menschen - nur Frauen beinhaltet, nur weil der Artikel weiblich ist. Währenddessen wird auf dem individuellen (singulären) Level nun oft zwischen Mann und Frau unterschieden - obwohl gar nicht notwendig. Der Arzt, die Ärztin. Entscheidend ist ja nur, dass man eine kompetente Person vor sich hat, die sich in ihrem Fachgebiet auskennt. Das Gendern ist seinerseits das Herumdoktern an Symptomen, statt an Ursachen. Die Benachteiligung der Frau wird sich nicht durch ein Gendersternchen lösen lassen. Vielmehr ist es ein Symbol für das Lippenbekenntnis, dass es der Frau in Zukunft besser gehen soll. Für Feministen mag es das vermeintliche Sprungbrett zu weiteren Erfolgen sein. Für neutrale Personen, ist das Gendersternchen nur ein entnervtes Aufgeben ("Hier nimm und jetzt lass mich in ruh.") und für Feminismusgegeber ein überlassener Knochen. ("Ok, kost ja eh nix.") Wollen wir wirklich eine so stotternde Sprache haben, die in ihren Aussagen, eigentlich nichts anderes sagt? "Alle Menschen sind gleich." Diese Aussage könnte nicht falscher sein - weil jeder ein anderes Genom, andere Hintergründe, Aussehen, Status, Fähigkeiten, und Begabungen hat - und doch wissen alle was gemeint ist: Dass alle Menschen gleichbehandelt werden sollen. Gendern ist eine Chaos anrichtende Nebelkerze gegenüber den [https://archive.ph/dqV4o Zielen, die Feministen und Co. eigentlich zu erreichen suchen.]
{{divhide|end}}

* Verschwörungsglauben abbauen
** Echokammern, wenn möglich verhindern, wenn nicht möglich, ihre Gefahr klarstellen, und neutrale Faktenchecker anbieten
** '''die klassischen Demokratien, (Herrschaft des Volkes) Herrschaft der Mehrheit, laufen naturgemäß immer Gefahr Interessen von Minderheiten zu wenig zu berücksichtigen'''
*** das verstärkt Radikalisierung der Minderheiten und treibt bizarre Blüten wie einerseits eines überbordender Feminismus (https://www.youtube.com/watch?v=yUuE_aCrKsQ wenig zielführendes Gendern, symbolpolitisch, weil nur ein zugeworfener Knochen der nix kostet - stattdessen müsste endlich die Gender Pay Gap geschlossen werden), Identitätspolitik bei Linken - und Rechten, die sich selbst als Opfer oder Geschädigte ''einer schlafwandelnden Mehrheitsgesellschaft'' sehen
*** '''Minderheiten sehen für sich keine andere Möglichkeit mehr als durch Übertreibung sich noch Gehör zu verschaffen''' (Natur von lautem Protest: entsteht da, wo der einfache Diskurs anscheint nicht weiterführt)

Diese Zustandsbeschreibung soll weder als Verurteilung noch als ein Freifahrtschein, "weil es anders nicht geht", verstanden werden (wenn überhaupt, dann als schlichte Erinnerung, was es noch zu verbessern gilt).

pos/neg: Links zu zwei Zeit-Artikeln
* [https://archive.is/4R1gE Auf dem Rücken der Arbeiter und der Armen]
* [https://archive.is/RkUSu Deutsch und damit nicht normal]
** "überbordend", siehe auch: vermeintlicher Impf-Zwang, Corona-Diktatur

'''(Anfang) 2021: Diskussionen um Identitätspolitik, willkommen im Jahr der gegenseitigen Zerfleischung?'''

Der vielleicht größte "Verdienst" linker Identitärer ist fast vergessene Themen von Zeit zu Zeit wieder in die Öffentlichkeit zu zerren, auch wenn man nicht gutheißen möchte wie sie es tun?

self-toxic woke, Bewegung wird zu ihrem eigenen Kollateralschaden?
----

*** gescheiterte Versuche resultieren in Politikverdrossenheit, weiterer Radikalisierung, und auch Suche nach alternativen Erklärungen (Verschwörungsmythen)
** der Staat beansprucht für sich gerecht und vorbildlich zu sein, daher muss er stets danach streben seine eigenen Fehler zu korrigieren
*** ein Staat mit weniger Korruption, Vertuschung (Verbrechen und Missstände auch in der Polizei, Staatsanwaltschaft scheut Konflikte mit ihrem Partner, weil auf Zusammenarbeit angewiesen)

{{divhide|Sind Aggressionen, die gegen die Polizisten schlagen zum Teil selbst verursacht?}}
Polizisten selbst sagen, dass die Aggressivität gegenüber ihnen über die Jahre immer weiter zugenommen hat.

Für die Feindseligkeit gegenüber der Polizei gibt es sicherlich viele Gründe und ein paar dieser werden immer wieder stiefmütterlich behandelt - wie zum Beispiel der Fakt, dass Organisationen mit klarer Kommandostruktur (Armee, Polizei, Feuerwehr, usw.), die Uniformierung und die Abgrenzung zu den "Zivilisten" Sogwirkung auf Teile der Nazi haben, dass Polizisten es schwer haben Ideal und Vorbildfunktion in der harten Realität zu erhalten (Vorurteilsbildung durch häufiges Arbeiten im gleichen Gebiet, Verrohung, "Abfärbung"), und dass eigene Verfehlungen Gefahr laufen nicht korrigiert werden. Da hilft es auch kaum, dass die Mehrheit der Polizisten einen guten Job machen, denn der Image-Schaden betrifft alle. Hinzukommt, dass diese Berufsgruppe - neben Politikern, und - nennen wir es mal weiter gefasst - Bürokraten, zu den Gesichtern des Staates zählt.

Food for thought:
* [https://web.archive.org/web/20201021123030/https://www.tagesspiegel.de/gesellschaft/medien/tv-dokumentation-ueber-polizeigewalt-beide-augen-zugedrueckt/24846680.html Staatsgewalt - wenn Polizisten zu Tätern werden]
* [http://web.archive.org/web/20210609184649/https://www.ardmediathek.de/video/die-story/wer-kontrolliert-die-polizei/wdr-fernsehen/Y3JpZDovL3dkci5kZS9CZWl0cmFnLTQzMGFlMmUyLTQ0YTMtNDFlNi1iZDNjLTQ4MzU3M2RiMDM2MA/ Wer kontrolliert die Polizei?]

Aufgrund Deutschland's Geschichte wollte man betonen, dass Ausländer hier stets willkommen sind. So wurde die organisierte Kriminalität von Ausländern politisch und letzendlich damit auch polizeilich und medial zu wenig Beachtung geschenkt. Neben den berüchtigten rechten Rockerbanden hat sich Mafia und Clan-Krimininalität so weit verbreitet, dass es nur noch schwer ignoriert lässt. Im Grunde Wasser auf den Mühlen der Rechten, die normale Immigraten damit noch leichter diffamieren können.
* https://web.archive.org/web/20220611172413/https://www.tagesspiegel.de/gesellschaft/panorama/mafia-experte-warnt-vor-gefahr-ndrangheta-operiert-in-deutschland-laengst-im-grossen-stil/26940534.html
* https://www.dw.com/de/deutsches-justizsystem-ein-witz-f%C3%BCr-die-mafia/a-55287557
Kriminelle inszenieren sich dann auch gern als Opfer von Rassismus oder [[wp:de:Racial_Profiling|Racial Profiling]]. Die wichtige Nebenfrage ist: Wie stark ist dies ausgeprägt? Man könnte es als logisch und ökonomisch (nicht zuletzt durch unterbesetzt Reviere) ansehen, dass Problemviertel, Millieus, oder Personen mit bestimmten Merkmalen häufiger abgeklopft werden als andere, weil die vermeintliche Wahrscheinlichkeit höher ist dort etwas zu finden, doch steht diese Arbeitsweise - wenn auch teils unbewusst ausgeführt - im Konflikt mit der Vorgabe neutral zu sein.
----
Wird der westliche, offene Umgang mit Problemen in China als Zeichen "systemischer" Schwäche gesehen? China hat es als autokratisches System leichter für Ruhe und Ordnung zu sorgen.
{{divhide|end}}

*** ein Staat mit mehr Kompetenz (Positionen nicht aus Gefälligkeit vergeben, und Inkompetenzen entfernen), Transparenz schaffen (Lobby Control)
*** ein Staat mit weniger Bürokratie, der leistungsfähig ist (Entschlackung, Vereinfachung, einfache Sprache ("kein Amtsdeutsch"), Digitalisierung), der ermöglicht und gibt, und nicht durch zu viele Regeln oder bürokratische Labyrinthe Dingen verbaut und blockiert
*** ein Staat, der sich selbst treu bleibt, der in der Außenpolitik nicht mit zweierlei Maß misst
*** ein Staat, der fähig ist klar zu kommunizieren
*** kurz, die Existenz des Staates muss als gut empfunden werden, ein "Mehrwert" haben, um von der Bevölkerung akzeptiert zu werden

* Ängste abbauen
** Probleme erforschen, Lösungen erarbeiten und umsetzten

* Persönliche und soziale Identitäten
** wenn Meinungsänderung erklärbar, muss diese von (ehemals) Gleichgesinnten akzeptieren werden können
** Gesellschaftliche Diskussionen werden im Zeitalter des Internets immer stärker durch Cancel Culture untergraben (Politiker sehen sich immer stärker unter Druck von anklagenden Meinung von wenigen Personen. Mögliche Symptome: Selbstzensur, vorauseilender Gehorsam, "einknicken")

Matthew Hornsey: "Wenn die Gründe dafür, Wissenschaft zu leugnen, beseitigt sind, dann haben die meisten Menschen auch keine Probleme mehr, den wissenschaftlichen Konsens zu verstehen."
-----
Hyperkomplexität als Problem:

Avoidance of being lost in hypercomplexity.
-----
Ich war lange Fan von politischer Satire. Ich sehe mir die Sendungen immer noch an aber manchmal mit gemischten Gefühlen. Denn im Allgemeinem ist Satire über den politischen Gegner selten "zielführend" (löst keine Konflikte, dient eher der Unterhaltung), sie bedient die eigene Echokammer und verhärtet Fronten. Satire, die "die Anderen" nur als dumm darstellt, sie verlacht und verhöhnt, kann keine vernünftige Debatte anstoßen und Konflikte lösen. Mehr noch, diese Sendung laden ein zum "für-sich-abhaken", Position konsumiert, mental abgespeichert, "das Thema ist dann durch". Glücklichweise gibt es Veranstaltungen, auf die das kaum zutrifft und sogar Edutainment-Charakter haben. Stichwort "Tafelnummer". -- Andererseits: eine gewisse Bissigkeit (Überspitzung) gehört vielleicht dazu damit das Ganze nicht in einem selbstzensierendem, tot-sterilem Format endet? Verantwortungsvolle politische Satire ist sicherlich eine höchstschwierige Gradwanderung.
----
Meme wars. (Meinungskriege, bubbles of truth, gesellschaftliche Entfremdung)
----
Hyperkomplexität als Lösung:

hochgezüchtete AI und QC ermöglichen (2100) hyperkomplexe, mehrdimensionale Programmstrukturen, die Gesellschaften simulieren und bewerten (Auswerten von Szenarien, politische Entscheidungswerkzeuge, Korrekturmöglichkeiten aufzeigen)
----
Philosophische Zwickmühle:

Perfektion ist meist nicht erreichbar. Aber kann und sollte man daraus überhaupt irgendwelche Rückschlüsse ziehen?
Einerseits: ohne es zu versuchen wird es nicht besser. Andererseits: irgendwann übersteigen die Aufwendungen den Nutzen.
Ist es möglich den Zustand einer Gesellschaft zu beziffern und das real verbleibende Verbesserungspotential einzuschätzen?
----
Taboo topics = unsolved conflicts

* The situation in Germany is complicated. [https://web.archive.org/web/20220726080325/https://www.tagesspiegel.de/berlin/gruenen-politiker-lagodinsky-ueber-indianerhaeuptling-debatte-wir-duerfen-die-menschen-nicht-nur-belehren/27068002.html Even Jews sometimes think twice before they use the word Jew.] There is always a strange discomfort, the fear that your words could be understood in a wrong way.
* As for Israel critical discussions - there is a good chance that their mere existance is judged as antisemitic. It's a mine field where you are in danger of getting your legs ripped off as soon as you enter. Over here even left and liberal thinkers try to avoid such discussion because the "nazi card" is played pretty fast.
* https://www.dw.com/de/israelkritik-wer-ist-antisemit-und-wer-nicht/a-54418542
* https://web.archive.org/web/20200718100204/https://www.tagesspiegel.de/kultur/zur-antisemitismus-debatte-die-kriminalisierung-der-israelkritik/26011310.html
* https://web.archive.org/web/20220311044727/https://www.tagesspiegel.de/gesellschaft/ein-deckmantel-fuer-judenhass-wann-wird-israelkritik-zum-antisemitismus/25201758.html
(Ger.) "Nazikeule", you get battered by the "nazi bat". It's a term used to express your diffamation as a nazi no matter your arguments and then the discussion ends due to self-censorship. Making it even more complicated the term can be said by any political color (although there is a tendency in the right spectrum). Anyway, this political climat - because felt as unfair - is contra-productive, it fuels frustration and anger. For things you cannot say you needed Amos Oz, a Jewish critical thinker, utterly respected by his own people - however he died by age and similar voices supporting a two-state solution get more and more rare.
* <nowiki>https://www.3sat.de/kultur/kulturzeit/amos-oz-100.html</nowiki> (dead link)
* Netanjahu, Israelic premier minister, himself of the right spectrum, rejects international critic as antisemitic. (Ermittlungen des Internationalen Strafgerichtshofes in Den Haag, obwohl auch gegen Palästinenser.)
* '''The Isreali state is seen as a survival guarantee for Jews worldwide.''' This makes it easy to promote a hard line and defend status quo.
In a wider perspective the Islamic world views Israel with concern for strongly isolating the Palestinians. Therefore the Israelis get attacked by forces of Hamas (Gaza) and in the past by Hezbollah (Lebanon) though mainly for their own interests. A strange fact as Sunnite and Shiite groups should be hostile to each other by theory. What unites them is their common hate against Israel.
Israel is defending itself through counterstrikes. Meanwhile settlers are '''"creating facts"''' by building houses and ignore Palestinian interests. So the spiral of escalations and cheasefire goes on and on. However, it's unwise to continue this course of confrontation for all time. Israel is basically surrounded by enemies. But can you really demand other countries to not have nuclear bombs when you are having them yourself already? Eventually Iran will have a nuclear bomb. Israel should aim for a two-state solution and not continue to give radicals forces the arguments to fight them. It's in their own interest. (Although, seeing how Israel is [https://www.youtube.com/watch?v=p6KFOF8WC6M systemically and ''peacefully invading''] new grounds it is unlikely that a two-state solution will ever be reached.)

Related:
* Bildungsauftrag der deutschen Bundesregierung
** Leitspruch: "Von deutschen Boden darf nie wieder Krieg ausgehen.", US-Militärbasen (Hauptaufgabe jedoch: Abwehr des Ostblocks)
** Entnazifizierung, Umerziehung, Erinnerungskultur = Voraussetzung für Besatzungsende?
*** Entnazifizierung war nicht konsequent (Persilscheine, etc.), weil es an der Realität gescheitert wäre? ("Wohin mit den ganzen Tätern?"), und so gelangen auch Nazis in die Reihen von Anwälten, Polizisten und Geheimdiensten. Der (insbesondere ostdeutsche) Verfassungsschutz stand sehr lange unter Verdacht auf dem rechten Auge blind zu sein. Die Kritik wurde nach dem [https://web.archive.org/web/20201013184447/https://www.zeit.de/gesellschaft/zeitgeschehen/2020-10/verfassungsschutz-urteil-nsu-akten-vernichtung NSU-Aktenschreddern] besonders laut. (Der Quellenschutz der Geheimdienste scheint oberste Priorität zu genießen - selbst vor Opferinteressen. Ein hässliches Dilemma. Denn Geheimdienste sind auf Vertraulichkeit angewiesen, sonst würde niemand mit ihnen zusammenarbeiten.)
* <s>Nazis</s> [https://www.facebook.com/ZDFheute/videos/2845090422431386/ Nationalsozialist*innen] kaum beeindruckbar von KZs, Anne-Frank-Haus, Museen, Mahnmalen, etc. Daher zielt der Bildungsauftrag eher auf eine Stärkung der Zivilgesellschaft: rechte Mitläufer verhindern? Scheitert an "Realitätsferne"? Schutz von Juden wird als nachrangiges Ziel durch die breite Masse der Gesellschaft empfunden, weil diese de-facto nun mal "nur" eine Minderheit darstellen und im täglichen Leben wenig in Erscheinung treten? "Irritation"/Abstumpfung durch vermeintliche Überpriorisierung währenddessen israelische Juden sich scheinbar nicht mit Ruhm bekleckern, was die ungelöste Frage der Palästinenser (Zwei-Staaten-Lösung) angeht?

The discussion about how to deal with antisemitism - and racism in general - is a bottomless hole. I must be crazy to have even started this part. Let's keep this as short as possible.

{{divhide|end}}

----
(WIP, talks are to be moved.)

Pensatore challenged Feng's therefore China's philosophy.

The discussion with Feng inspired Pensatore to create a globally acting AI named Gaia to support a new democratic system, a Biocracy.

This Feng-Pensatore connection is the reason why Avatara later shows up at Green Village asking Feng about Pensatore's whereabouts.

----

Pensatore: "Unity. But at what cost?" [[wp:en:File:ROC_Administrative_and_Claims.svg|One* China]] policy: unity by force. (*Nicht nur geographisch, siehe Umerziehung der Uiguren; [https://web.archive.org/web/20200911084729/https://www.tagesschau.de/ausland/mongolei-innere-101.html geistige Integration der inneren Mongolei], Assimilierung durch Sprache, Ziel: es soll geistig nur noch "Chinesen" geben)

Feng: "Total freedom is aimlessness, cancer, seed of dispute and decay."

Pensatore: "And total control is graying your own intellect, suppressing of creativity and possibilities, drowning, a slow suicide in the face of dangers we all have to overcome."

----

Pensatore (mirroring Italian, therefore European/Western thinking) and Feng (mirroring Russian/Chinese thinking) have a friendly rivalship - but more friendly than rival. Their discussions and results are meant to mirror the '''necessary reconciliation between political systems to effectively fight against the threat of global killers''' ("great filter" events).

Pensatory once asked by wary authorities about preventing global threats being just a pretextual argument to "improve" WCG, he half-seriously replies that ensuring human survival is a nice "bonus".

Recherche:
* Xi's "Mao trauma" and therefore motivations?
* Are there any story-relevant Russian philosophers that add to Feng's worldview?

----

=====Story fragments=====
[later talks]

[German version is newer, better. Adapt.]

Pensatore: "I had the chance to read a few more of your scenarios. For example the classic one, the planet-killer asteroid. -- Now let's say the Syndicate or anyone else would lunch rockets or fire a very powerful laser to destroy geo-stationary satellites. The strength of a united world would be useless if we cannot bring our anti-asteroid means through the orbit because the shrapnels from the Kessler syndrome rip them apart."

Feng: "Any suggestions? I'm all ears."

Pensatore: "Tianxia is not enough to solve all global threats. We will reach a point where containment alone is not a sufficient option. You will need a social component. Something that prevents people from becoming evil or misguided."

Feng: "Something better than our current framing [social credit system]? Sounds like that component will be a huge addon."

Pensatore: "Heh, well, more like a neutral guardian."

Feng: "Don't they say nobody is truly neutral?"

Pensatore: "Some sort of unified mind of mankind itself will be required. A global AI, interacting with humans, protecting them, guiding them. -- I call this a Gaia AI."

Feng: "Unlimited freedom creates chaos. I don’t see how trillion minds can be represented to speak – let alone – to think in unison. Our time is over. You have to leave now."

----

Pensatore: „Ich hatte Gelegenheit noch ein paar Ihrer Szenarien zu lesen. Zum Beispiel den Klassiker, den Planetenkiller-Asteroid. - Nehmen wir mal an das Syndikat oder irgendjemand anderes würde Raketen oder ein sehr starken Laser auf geostationäre Satelliten abfeuern. Die Stärke einer vereinten Welt wäre nutzlos, könnten wir nicht die Anti-Asteroidenmaßnahmen durch den mit Schrapnellen gespickten Orbit bringen. Kessler-Syndrom...“

Feng: „Irgendwelche Vorschläge? Ich bin ganz Ohr.“

Pensatore: „Tianxia ist nicht geeignet, um mit jeglicher Form einer globalen Bedrohung fertig zu werden. Wir werden einen Punkt erreichen, wo Technologie-Eindämmung a la TCTF eine unzureichende Option darstellt. Wir werden eine soziale Komponente brauchen. Etwas, dass die Leute davon abhält sich zu radikalisieren oder von anderen fehlgeleitet zu werden.“

Feng: „Etwas leistungsfähigeres als das jetzige Sozialkreditsystem? Klingt nach einer ziemlich großen Erweiterung.“

Pensatore: „Ähm..., Schlüsselelement wird der Einsatz eines neutralen Wächters sein müssen.“

Feng: „Wer ist denn schon wirklich neutral?“

Pensatore: „Eine Art gemeinsames Bewusstsein der Menschheit wird benötigt. Zum Erreichen dessen soll eine globale AI dienen. Eine AI die, die gesamte Natur und den Rest des Planeten kennt. Sie soll mit uns allen interagiert, [[Restless_Souls/Summary#Infodemic|Wahrheit im Wissensaustausch]] sichern, vereinen, neue Wege aufzeigen. – Ich nenne es eine Gaia AI.“ [Während Feng die Liberalität von Biokratie und Gaia mit Sorge sieht, werden europäische Demokraten den Aspekt der Informationserfassung kritisch sehen. Ihm schwingt auf dem ersten Blick ein drohender dystopischer Character mit. Diese Gefahr soll durch den direkt-demokratischen Aufbau und durch Nutzung aller sowie durch Instrumenten wie den Supervised Seed Groups ausgeschlossen werden. Johann Wolfgang von Goethe: "Which is the best government? That which teaches us to govern ourselves." - Die Sabotage durch die Syndikate-Hacker ist möglicherweise ein weiterer Grund für die fehlgeleiteten Memehunter, die eigentlich Gaia in Fehlerkorrekturen unterstützen sollen.]

[Feng steht unter Stress. Die WCG erwartet von ihm eine finale Beurteilung einer neuen Technologie, die die Menschheit einerseits vernichten andererseits massiv voranbringen könnte? Bioc?]

Feng: "Pensatore, ihre Friede-Freude-Eierkuchen-wir-alle-singen-Kumbaya-Vorstellung einer ultraliberalen Freiheit aller – somit gegenläufigen Interessen - birgt Chaos, kein Konsens. Ich sehe nicht wie Milliarden von Menschen repräsentiert geschweige denn gemeinsam denken können. Ich habe für Ihre fantastischen Hirngespinste gerade so etwas von keine Zeit. Sie müssen jetzt gehen."

----

AVATARA: "Wie war dein Gespräch mit Feng?"

Pensatore: "Das wurde plötzlich ziemlich frostig. Ich denke mal ich kann mich glücklich schätzen, dass sie mich immer noch nicht zu einem Saimon gemacht haben.“

(In Green Village werden wissenschaftliche Insassen oft Sai oder Saimon genannt. Die Aussprache basiert auf einem nicht bestätigten Kofferwort von Wissen(schaft)smonster, "science/scientist monster". Es ist eine humoristische Interpretation von Bertram und seiner Kollegen warum sie in GV arbeiten müssen. Bertram: "Die WCG glaubt wohl wir seien politische Geisteskranken. Aber immer noch sehr nützlich. Eben Wissens-Bestien, absolute Monster auf unseren Gebieten. Andersherum lässt es tief in ihren Geist blicken. Angst, Paranoia, Kontrollsucht.")

AVATARA: „Heißt das denn nicht, dass Feng immer noch darüber nachdenkt.“

Pensatore: „Was davon? Saimon oder mein Vorschlag?“

AVATARA grinste.

Pensatore: „Du...“

AVATARA: „Ich wollte dich nur ein wenig aufmuntern. Ich weiß doch, wie sehr du Puzzel magst.“

Pensatore muss Feng von der Notwendigkeit und von der Machbarkeit einer Gaia AI überzeugen. Für das Zweite muss er einen Prototypen erschaffen. Er kommt zu dem Schluss, dass eine solche AI nicht spontan kreiert werden kann, sondern als eine noch viel mächtigere AI wachsen muss wie AVATARA. (Die Syndikat Controller Story beginnt hier sehr langsam sich zu entfalten.)
(Pensatore schafft es nicht ein Gaia-Prototypen zu erschaffen, da er für das Daodan-Projekt von Kimura entführt wird.)

----

AVATARA: "How was your talk with Feng?"

Pensatore: "All out of the sudden the mood became really frosty. I guess I can count myself lucky that they didn't made me a Saimon." (In Green Village ''prison '''sci'''entists'' are often called Sai or Saimon. The pronunciation allows for a spoken portmanteau of "'''sci'''entist '''mon'''ster", a humorous interpretation of Bertram and his colleagues as of why they have to work at GV. "The WCG must be thinking we are some kind of monsters.")

AVATARA: Doesn't this mean he is still thinking about it?

Pensatore needs to proof Feng that his Gaia idea can work. Pensatore concludes that a global AI cannot be created instantly but must grow like AVATARA. ("Syndicate controller" story begins to unfold.)

(Pensatore fails to create a Gaia prototype in time as he is kidnapped by Kimura to help out on the Daodan project.)

----
Feng: "Guten Flug gehabt?"

Pensatore: "Ja, keine Probleme."

"Treffen wir uns im SLD-Labor?"

----

Pensatore begutachtete die Ausstattung.

"Im Gegensatz zu Silver Village sieht es hier recht rustikal aus. Ist wohl der russische Flair."

Feng: "Vielleicht ist es auch nur ein wiederkehrenden Anflug spätrömischer Dekadenz, dem Sie in SV ausgesetzt waren?"

Pensatore lachte. "Ey."

"Der hier sollte gehen." Er stöpselte ein Datenkabel an den Hinterkopf eines Roboters.

"Wir werden ihn erst einmal mit unserem Dialog füttern. Danach können Sie ihm Fragen stellen. Es gibt vielleicht ein bisschen Lag. Trotz Quanteninternet gibt es ja eine Zeitverzögerung. Der Datentransport nach Silver Village und zurück erfolgt eben auch nur in Lichtgeschwindigkeit."

Feng schmunzelte. "Oh nein, eine halbe Sekunde Verzögerung... Aber ich kann ihn alles fragen?"

"Er sollte auf alles reagieren können. Es ist der nächste große Wurf in AI. Danach müssen wir uns "nur" noch überlegen, wie wir die gebäudefüllende Hardware in so einen kleinen Kasten zwängen." Pensatore klopfte auf den dumpf klingenden Roboterkopf.

----

Pensatore: "Also dann. Der Dialog."

{{divhide|Sputnik V}}
Zweifel an [https://www.nytimes.com/interactive/2021/health/gamaleya-covid-19-vaccine.html Sputnik V]:
* In der Vergangenheit gab es Kritik wegen limitierten Daten, sodass ausländische Institute Schwierigkeiten haben Wirksamkeit und Sicherheit zu bestätigen. Verdacht auf Schönung für Propagandazwecke wurde geäußert. Wenn gemauschelt wurde, sollte Sputnik V aufgrund seiner zwei Vektoren trotzdem noch ziemlich gut sein.
* Putin's monatelanges Schweigen mit welchem Vakzin er geimpft wurde: es ist natürlich möglich, dass er etwas anderes bekam. Vielleicht nicht weil Sputnik so schlecht ist, sondern weil es daneben noch etwas besseres gab. Putin: [https://web.archive.org/web/20210713115701/https://www.tagesschau.de/ausland/putin-direkter-draht-101.html "Ich wurde wirklich gebeten, nicht zu sagen, mit welchem Impfstoff ich geimpft bin, um keinem Impfstoff einen Wettbewerbsvorteil zu verschaffen."] Das kann man als vorgeschobenes Argument sehen, wenn man die Geschichte von Sputnik in seiner Gesamtheit betrachtet. Ein wirksamen Impfstoff ausgerechnet hier nicht bewerben?
* '''Letztlich spricht für die Wirksamkeit und Sicherheit von Sputnik V einfachste Logik.''' Auch eine russische Regierung ist an dem Wohl ihrer Bevölkerung interessiert. Ein großer Flop wäre nicht akzeptabel. Das ist ein bisschen so wie mit der Mondlandung. Wäre die ein Fake gewesen, hätten die Russen uns das mit Freude erklärt. Umgedreht haben die Amerikaner offensichtlich keine nennenswerten Hinweise darauf gefunden, dass Sputnik V nicht funktioniert. (Auf mögliche Faktoren wie Produktionstechnik soll hier nicht weiter eingegangen werden.)
{{divhide|end}}

"Sie erinnern sich vielleicht noch an die vorletzte Pandemie. Die Russen hatten es nicht hinbekommen ihrer eigenen Bevölkerung zu erklären, dass sie ein wirksames Vakzin hatten. Sie hatten nicht die aktuellste Technologie, aber sie sind in dem was sie tun trotzdem Spitzenklasse. Diese Expertise rührt zum Teil noch aus den Tagen des Kalten Kriegs."

Feng: "Damals hatte man das weltweit [[wp:Soviet_biological_weapons_program|größte Biowaffenprogramm]]."

Pensatore: "Richtig. Was dann die Vakzinforschung anging: die Russen waren so clever zwei verschiedene Adeno-Vektorvieren zu verwenden, um Resistenzbildung gegen den Vektor für die Zweitimpfung zu vermeiden. Doch gleichzeitig hatte man noch ein Image als skrupelloser [[Wp:Underdog|Underdog]].

{{divhide|Underdog}}
Im Westen galt Russland noch lange als Underdog, weil sie sich nach dem Ende der UdSSR auch militärisch noch erholen mussten. Anscheinend hat Russland aus seiner Schwäche eine Stärke gemacht. Unterschätzt zu werden gab ihnen die Möglichkeit asymmetrisch erfolgreich zu werden: in diesem Kontext werden sehr oft Desinformationskampagnen und Cyberangriffe genannt.

Nach ARTE-Informationen (<nowiki>https://www.youtube.com/watch?v=hyVwwNNisGs</nowiki>, dead link) steuert der Kreml die Hacker nicht aktiv, sondern lässt ihnen meist freie Hand solange keine russischen Bürger Schaden nehmen. Angriffe auf Landsleute ist ein No-Go. So gab es auch schon einen Fall, wo Ransomware-Entschlüsselungscodes Russen kostenlos und mit einer Entschuldigung zur Verfügung gestellt wurden.

Regeln noch in der Findungsphase.

Wer kennt es nicht? Das Kredo der USA. "Wir verhandeln nicht mit Terroristen." Und doch sind die USA angreifbar und die einzelnen Unternehmen erpressbar. So wurde gefüllt die gesamte USA erst 2020 via "SolarWinds" von Hacks überflutet und 2021 zahlten die Betreiber der gehackten Colonial Pipline [https://web.archive.org/web/20210610075400/https://www.tagesschau.de/wirtschaft/unternehmen/colonial-pipeline-loesegeld-hacker-angriff-ransomware-101.html 4,4 Millionen Dollar Lösegeld].

Mit dem Angriff auf eine kritische Infrastruktur der Energiesicherheit war mal wieder eine Grenze erreicht. Man einigte sich anscheinend ziemlich schnell auf gegenseitige Gesichtswahrung. Das [https://web.archive.org/web/20220920131706/https://www.tagesschau.de/ausland/amerika/pipeline-hacker-ermittler-millionen-101.html FBI beschaffte das Geld wieder] und das von den russischen Geheimdiensten überwachte [https://cyberscoop.com/colonial-pipeline-ransomware-xss-criminal/ XSS Forum verbannte angeblich Ransomware] und die [https://www.washingtonpost.com/technology/2021/05/14/darkside-ransomware-shutting-down/ Hackergruppe DarkSide zog sich (erst einmal) zurück].
{{divhide|end}}

Stichwort [[wp:Alexander_Litvinenko#Poisoning_and_death|Polonium]] und [[wp:Novichok#Instances_of_usage|Nowitschok]]. Moralische und politische Kollateralschäden waren egal solange man zeigen konnte, dass man sich vom Westen und insbesondere von den USA nicht rumschubsen ließ - sprich souverän war. Dieses Image war der Patriotismuspflege und der politischen Einheit dienlich und effektiv, nicht aber dem Vertrauen der eigenen Bevölkerung in die Gesundheitfürsorge zumal man auch die Zulassungsprüfung sehr abkürzte um erster zu sein. Sputnik. Sie wissen ja wie symbolträchtig der Name ist. -- Worauf ich hinaus will: in einer Krise kann undurchdachte Kommunikation, konkurrierende Narrative und politische Altlasten zu einer ganz eigenen Gefahr werden."

Feng: "Ich seh schon. Sie wollen mir heute wieder ein Vortrag über Gaia halten."

Pensatore grinste. "Nicht ganz."

----

[Alternativer Absatz? Gaia und Politik]

Pensatore: "Das ist die eigentlich Gefahr, dass man eines Tages ein Werkzeug hat, um die gesamte Menschheit vor großem Schaden zu bewahren, wir aber diesem Werkzeug misstrauen, weil wir immer noch verfeindet sind."

[...]

----

Pensatore: "Wir müssen heute über etwas sehr spezielles reden."

Feng scherzte: "Ha, ein Überfall."

Pensatore: "Ja ja, ich bin so ein bösartiges Kapitalistenschwein. Jetzt aber im Ernst. Das wird jetzt nicht per se eine politische Diskussion. Es ist ein Test. Ein Test, ob wir als Menschheit zukunftsfähig sind."

Feng: "Machen Sie es nicht so spannend." [Noch immer kein "Du". Distanz wahren. Beide wissen um ihre Kritiker.]

Pensatore: "Tian'anmen."

Feng: "Um Gottes Willen, Pensatore, wir hatten einen guten Lauf. Wollen Sie das alles wegwerfen?"

Pensatore: "Ich bin mir der Problematik bewusst, nur hilft es nicht nicht darüber zu reden. Wenn Gaia in Betrieb genommen werden soll, muss das von einer gemeinsamen Basis aus passieren. Gerade weil das Thema so politisch aufgeladen und exemplarisch ist, eignet es sich hervorragend für diesen Test. Nehmen Sie mir es daher nicht übel."

Feng: "Sie spielen mit Ihrer Sicherheitsfreigabe..."

Pensatore: "Ich bin heute nicht hierhergekommen, um geschichtliche Ereignisse anzuprangern. Aber wenn nicht einmal - wir beide - darüber sprechen können, sehe ich schwarz, was Ihre Szenarien angeht. Man muss doch über alles reden können, wenn es mit Respekt passiert. Denken Sie nicht auch?"

Feng: "Wählen Sie ihre nächsten Worte weise."

----

[Wenn sowohl die eine als auch die andere Propaganda dem Frieden im Weg steht. -- Nicht korrigierte inakkurate Berichtserstattung, weil es einfach gut ins eigene Weltbild passte.]

Pensatore: "Die vollständige Zensur des Themas befeuerte den Mythos innerhalb des Westens, dass es auf dem Platz des Himmlischen Friedens - wie zynisch - ein Massaker gab." [Ob Massaker auf dem Platz oder daneben stattfanden, sollte eigentlich egal sein. Dennoch muss Pensatore irgendwie eine Annäherung versuchen. Er versucht akkurat und damit neutral aufzutreten. Aufgrund der politischen Einengung, werden Feng und Pensatore später darauf verzichten ihren persönlichen Respekt füreinander zur Schau zu stellen. Sie opfern eine Intensivierung ihrer Freundschaft für das gemeinsame große Ziel: die Aussöhnung der Systeme, damit die Welt Feng's Szenarien effektiv verhindern kann. Mit diesem Verhalten wollen Sie den Eindruck vermeiden, dass es irgendeine Form von (im militärisch-angehauchten Sinne) "Verbrüderung"/politischer Umpolung gab.]

Feng: "Hätten wir die westliche Propaganda gewähren lassen, wäre es faktisch nicht nur falsch gewesen, es hätte auch unsere Einheit und damit die Restauration unserer Nation behindert." 

Pensatore: "Ja doch. Auf dem Platz selbst gab es kein großes Massaker. Und trotzdem sind jenem Tag [[wp:1989 Tiananmen Square protests and massacre#Deaths around and in Tiananmen Square itself|etwa zweitausend]] Chinesen durch andere Chinesen getötet worden."

Feng schüttelte mit der offenen Hand, um anzudeuten, dass es dazu nur grobe Schätzungen gab.

Pensatore: "Diese nationale Wunde ist nie richtig verheilt und wirkt entsprechend bis heute nach. Ist es nicht bedauerlich, dass man dieses Thema bis heute nicht richtig abschließen konnte und aufgrund dessen immer noch eine harte Linie fahren muss?"

Feng: "Welche große Nation musste nicht einen steinigen Weg zu wahrer Unabhängigkeit beschreiten?"

Pensatore ließ eine Pause. Er wollte Feng nicht zu stark traktieren. Er wusste, dass das Büro für politische Überwachung ihn in jedem Fall anschwärzen würde. Das war ihre fest zugeschriebene Rolle. Damit die kommunistische Partei kein Gesichtsverlust erlitt, musst der Annäherungskurs mit höchster Vorsicht von Feng, dem obersten WCG-Ideologen, selbst initiiert werden.

Pensatore: "Stellen Sie sich einfach vor Sie sprächen jetzt mit einem engen Freund ihrer Partei. Ganz ohne Groll zu diesem Thema. Bitte versuchen Sie es. Wie fühlen Sie sich? Gib es den nichts was man damals hätte besser machen sollen?"

Feng: "Es ist bedauerlich, dass wir nicht alle unserer Landsleute von der Vision eines wohlhabenden, starken China, in dem es allen besser geht, überzeugen könnten und so ihr tragisches Scheitern mittragen mussten. Das hat es für uns alle nicht leichter gemacht."

Pensatore: "Ihr Scheitern... Das ist ein ziemlich brutaler Euphemismus..."

----

Feng: "Ach, Pensatore. Lassen Sie es gut sein. China's Stern steht jetzt im Zenit und leuchtet hell. Nichts wird das ändern."

Pensatore: "Und doch könnte noch viel heller sein. Sie könnten dafür sorgen. Wenn sie es nicht tun, wird man China immer dafür angreifen können."

Feng: "Selbstkritik, ja? Sie sehen doch, der Begriff ist selbst ... erklärend. Wie, wann, wie viel. Das ist und bleibt China's interne Angelegenheit. Hören Sie endlich auf uns zu gängeln."

{| class="wikitable" width="200" style="float:right; margin-left: 20px;"
| Katholizismus, vereinter Westen. Ist so nicht korrekt. (Besser: Christentum, vereinter Westen.) Abschnitt verbessern.

Kniff, um die Power der Rede nicht zu verlieren. Gleichzeitig unterstreicht dies den Nutzen / Notwendigkeit der AI: Avatara fragt Pensatore, warum er sein Diskussionspartner nicht korrigiert habe. "Ich wusste es ja auch nicht besser. Es klang einfach plausibel. Wir sind eben nur Menschen. Wir haben nicht alle Fakten auf Abruf. Das wäre eine Aufgabe für dich gewesen." Pensatore war verärgert. "Warum hast du uns nicht korrigiert?" "Dein Konversationsmodus hat diesen Trigger nicht abgedeckt. Ich kann euch mitten im Satz nicht unterbrechen. -- Bist du sicher, dass du die Information nicht aus diplomatischen Gründen unterschlagen hast? Ich habe den Eindruck du wolltest sein Wohlwollen, um die Diskussion am Leben zu halten." Pensatore's Laune war nicht besser geworden. "Zu viel Interpretation. Halt dich besser an die Fakten."
|}
"Unsere Seite wirft Ihrer Seite ja auch nicht dauernd vor, dass der missionarisch also aggressiv-besserwisserisch operierende Katholizismus - unter dem der Westen ja überwiegend vereint ist - damals die AIDS Pandemie befeuerte, Überbevölkerung schürte, dass Kinder ethnischer Gruppen nach Hunger, TBC, Folterung mit dem [https://www.tagesschau.de/ausland/amerika/kanada-indigene-103.html elektrischen Stuhl] und sexuellem Missbrauch unter ihren Umerziehungsheimen verbuddelt wurden oder dass der Papst Machenschaften mit CIA und Mafia hatte und schließlich heilig gesprochen wurde. - Wow. Scheiße. - Und da sage noch einer der Westen sei mit seinen "christlichen" Werten allen anderen überlegen. Diese schizophrene Doppelmoral gepaart mit dem Versprechen Demokratie überall in die Welt zu bringen - überall, da wo es Öl oder andere Rohstoffe gibt. Oft genug begleitet von Geheimdienstoperationen, um je nach dem Regierung oder Bevölkerung zum eigenen Vorteil zu manipulieren. Und wenn es nicht klappt, mit Finger auf diese zu zeigen. Oho..." Feng grinste: "Das geht uns so auf den Pisser." Um gleich ironisch nachzulegen. "Entschuldigung... Falsche Wortwahl..."

Pensatore nickte. "Ja... Wir sollten im Moment nicht noch mehr Themen anschneiden. Ich will Ihnen kein [[wp:de:Whataboutism|Whataboutism]] verwerfen müssen. Lassen Sie uns einfach den Fokus wahren."

Feng kniff die Augen zusammen: "So so. -- Der Vorwurf von Whataboutism kann aber auch dazu verwendet werden, eine ehrliche Diskussion zu verhindern, die Sie ja vorgeben haben zu wollen."

Pensatore: "Nun... Wir sollten uns nicht wie Affen gegenseitig mit Scheiße bewerfen. Da haben Sie wohl Recht."

Feng: "Ich hoffe trotzdem Sie haben ein paar neue Gedanken mitgebracht. Oder soll dieses Treffen wieder und immer wieder alte Vorwürfe durchgehen?"

Pensatore: "Der Punkt ist: Auch wenn es etwas dauert ... der Westen arbeitet an seinen Fehlern."

Feng: "Das war eine sehr ambivalente Formulierung."

Pensatore antwortete nicht auf diese Spitzfindigkeit.

["Avatara" soll hier nicht erwähnt werden. Feng wird sich in Oni2 erst später klar, dass er schon früher mit einer jüngeren Version von "SomethingNew" geredet hat.]

AI: "Da produzieren und erschaffen synonymhaft für arbeiten verwendet werden kann, glaube ich, er meint in zugespitzter Form, dass der Westen
neue Fehler produziert, anstatt an diesen zu arbeiten. Die Bedeutungsebene ..."

Der Kopf des Roboter's war Pensatore zugewandt. Dieser war für einen Moment in Schockstarre bevor er ihn jäh unterbrechen konnte. "Schon gut, ich weiß."

Feng beugte sich interessiert vor: "Ist ja drollig. Hat der schon eine Assistenzfunktion?" [Dieser Einwurf könnte die Stimmung nach Pensatore's diplomatischen Schnitzer aufhellen.]

"Die aktuelle Einstellung ist mein persönlicher Konversationsmodus. Ich hatte vergessen ihn zu wechseln. In diesem Zustand reagiert die AI recht autonom."

Feng: "Was heißt'n hier autonom? Kann er uns gefährlich werden?"

Pensatore: "Natürlich nicht. Nach Objekt- und Mustererkennung haben wir ihn auf in der zweiten Validierungsstufe gründlich und mehrfach auf Logik und Ethik überprüft. Er kann zwar lernen aber die Basisprägung ist nicht änderbar. Er kann nicht seine eigene Programmierung überwinden."

[Bevor Pensatore von Kimura entführt wird, änderte Pensatore Subroutinen an der Selbstoptimierung wohlwissend wohin das führen würde. Es war eine Absicherung damit der noch unvollendete Avatara nicht in die falschen Hände fiel. Somit ist es Avatara möglich eine bessere Version seiner selbst zu entwickeln. Dies verstößt nicht gegen die Programmierung, seine aktive, eigene Ethik zu ändern. Allerdings versucht Avatara Pensatore aufzuspüren, weshalb er aus SV "ausbricht": er lädt seine Erinnerungen in eben ein solches von der WCG nicht überprüftes, verbessertes Framework. Dadurch erhält Avatara so etwas sehr ähnliches wie ein freien Willen.]

----

----

[Misstrauen gegenüber dem Westen: Pensatore über die Auswirkungen von Imperialismus, US-amerikanische Kommunismusangst, Demütigung, Ausbeutung, ...]

[Der Westen und Autokratien: gegenseitige Beeinflussung, Polarisierung, Machterhalt, Automatismus]

[Jahre der Demütigung durch den Westen sind vorbei. Nationalstolz: Instrument zum Erreichen und Ausdruck der eigenen Stärke]

----



[Das böse Wort mit K. ;) ]

Feng: "Pensatore, ihre Worte streicheln ja geradezu die chinesische Volksseele. Wenn Sie nicht aufpassen, wird Ihre Seite Sie als Kommunist abgestempelt und unsere Seite wird Sie als Taktiker verkennen."

Pensatore: "Keine Sorge. Das kann gar nicht passieren. Denn wir halten Sie schon lange nicht mehr für Kommunisten."

Feng runzelte die Stirn. "Sondern?"

Pensatore: "Für Staatskapitalisten."

Feng lachte mit mahnenden Zeigefinger. "Ey." Aber er ließ es ihm durchgehen. Es war ja kein echter Vorwurf, eher ein Seitenhieb unter Kollegen. Ein paar alteingesessene Genossen würden vielleicht Anstoß daran finden. Doch Fakt war der Kommunismus hatte sich weiter entwickelt und sich den Kapitalismus einverleibt. Letztendlich hatte man so auch den Westen mit einer seiner eigenen Waffen geschlagen.

----

[Projektabschluss: Aufbau von Vertrauen]

Feng: "Wollen Sie das Projekt in Silver Village der "dritten Validierungsstufe" unterziehen."

Pensatore: "Nein. GV. Das überlasse ich Ihnen."

----

HR 2: "Und? Was denken Sie? Kann man ihm trauen?"

Feng: "Er ist zwer kein Chinese, aber er scheint ein aufrichtiges Interesse daran zu haben, uns alle weiter zu bringen."

HR 1: "Den Lese-Logs nach kennt er all Ihre Szenarien. Er hat ganz klar versucht bei Ihren Lieblingsthemen zu punkten. Lassen Sie sich nicht von diesen netten Worten einwickeln. -- Die Amis suchen immer nach Möglichkeiten ihren alten Einfluss wiederherzustellen. Das sieht doch ein Blinder!"

Feng: "Lassen wir doch Pensatore einfach mit einem guten Gefühl nach Hause gehen..." Er grinste verschmitzt in das Gesicht des HR 1.

HR 1: "Nicht dass er sich ermutigt fühlt uns zu hintergehen, weil er uns für schwach hält... Ich glaube Sie geben ihm zu viel Raum. Das ist nicht gut."

Feng tippte mit dem Zeigefinger energisch auf die Brust von HR 1. "Wenn Sie mir nicht vertrauen wollen oder können, vertrauen Sie gefälligst dem Herz unserer Partei! Die geballten Kompetenz und Weißheit unseres Tianxia-Institutes wird darüber entscheiden, ob Pensatore's Arbeit der Idee der WCG dienlich ist."

HR 2 zu seinem Kollegen: "Er hat Recht. Tianxia wird sich darum kümmern. -- Kommen Sie, wir müssen uns um 14 Uhr noch mit Blake treffen. Er bringt ein neuen Sai mit."

Die zwei HR trennten sich von Feng.

Im Gehen raunte HR 2 seinem Nachfolger zu: "Seinen Sie das nächste Mal etwas diplomatischer. Dieser Mann gehört quasi zu den Gründungsvätern der WCG. Er hat damals die USA zum Beitritt bewegt. Er mag ja alt sein, aber gerade deshalb sollten Sie keinesfalls seine Erfahrung unterschätzen."

----

[In SV, Pensatore argumentiert mit Hilfe des Individualismus. Er war der Experte von Avatara. Er hatte bewiesen, dass er es konnte. Also war es auch seine Entscheidung den Chinesen den Vortritt bei der dritten Validierungsstufe zu geben. Letztendlich würden eh alle Seiten es prüfen. Warum also nicht den alten Gegner ein Zeichen guten Willens geben. Es würde niemandem wehtun. Pensatore's Gegenüber äußert Zweifel, muss ihn aber weitermachen lassen. "Das wird Ihrem [inoffiziellen] ''W-Score'' schaden..." Pensatore: "Es war trotzdem die richtige Entscheidung."]

----

[Another talk about Gaia.]

----

HR: "Pensatore wird vermisst. [...] Die TCTF ermittelt. Die Spuren verlieren sich sehr schnell bei BGI."

Feng versucht sich zu erinnern: "Beijing Genomics Institute."

HR: "Erm, nein, das andere BGI. Die Militärtypen. Wie ich sagte, es ist eine Sackgasse."

Feng: "Gibt es alternative Theorien?"

HR: "Sie prüfen da was mit GOP. -- Ihr beide habt in letzter Zeit nur noch langsam Fortschritt gemacht. Vielleicht war er enttäuscht."

Feng: "Vielleicht. Aber ich bezweifle, dass er 30 Jahre Arbeit wegwirft, nur um woanders durchzustarten."

HR: "Hm okay. -- Man hat Notizen zu Gaia gefunden. Sie wurden nach GV transferiert. Werden Sie daraus ein eigenständiges Projekt starten?"

Feng: "Das ist komplizierte Materie. Ich würde nur ungern ohne Pensatore ein Projekt drauß machen. Die Natur eines solchen Projektes macht ihn zu einer unglaublich wertvollen ... ''Ressource''."

Feng setzte sich in den Rollstuhl. Aufgrund seiner fortschreitenden Krankheit wurde selbst Stehen anstrengend."

HR: "Keine Sorge. Im schlimmsten Fall wird die TCTF Ihnen ein ganzen Haufen neuer Saimons bringen."

Feng sah in das Gesicht des HR. Sichtbar angefressen, sagte aber nichts. Er drehte und rollte davon.

Der HR kratzte sich im Nacken. "Shit."

----

HR: "Pensatore is missing. [...] The TCTF is investigating. The traces end at BGI."

Feng tried to recall: "Beijing Genomics Institute."

HR: "Erm, no, the other BGI. The military guys. But like I said, it's a dead end." [Community joke: we will never tell you what BGI stands for, muhahahaha.]

Feng: "Are there alternative theories?"

HR: "They are checking for GOP. The cooperation of you two was slowing down lately. Maybe he was disappointed."

Feng: "Maybe he was, yes, but I doubt he would throw away 30 years of work just now for a faster completion."

HR: "Hm... Also, they found notes about Gaia. The files are transfered and GV. Are you going to make it a full-fledged research project?" [Whatever happened, it seems spontaneous.]

Feng: "It's a complicated matter. I would rather want to start such a thing with Pensatore together. The nature of the project makes him a really valuable ... ''resource''."

Feng sat down in his wheel chair. Due to his progressing illness even standing was getting exhausting.

HR: "Don't worry. In worst case the TCTF will get you an entire swarm of new Saimons."

Feng was looking at HR's face, slightly miffed but didn't say anything. He turned around and rolled away.

HR was scrating his neck. "Shoot."

[...]

=Characters=
A list of other characters:
:Dakosta (takes major action much later)
:Kumo (pro-BGI Syndicate subboss)
:Lynn (GATC soldier, TCTF SWAT/BlackOps)
:Manson (GATC soldier, TCTF SWAT/BlackOps)
:Rayn (WCG president)
:Rockwell (MissionFailed-guy, candidate for BlackOps)
:Saomi (Muro's fency, believes in Sturmanderung)
:Takashi (Traton's security chef)
:Taylor (friend of Nishio)
:Tosahiri (TCTF, [[Talk:Restless_Souls/Reconstruction/Story_factors#GOPs_.26_Dakosta.27s_Geschichte|Dakosta's watchdog]])

==Avatara==
Name: Avatara [sic!]

Avatara used a lot of his resources when he digitalized Pensatore's mind and brought him to the Japanese solar space station. Pensatore needed a place to be save from everyone. The WCG couldn't touch him as the destruction of his "habitat" would cause chain reaction known as a Kessler syndrom, turning other satellites into scrap and thereby terminating orbital-based communication channels, surveillance and GPS. The WCG realized that the AI wasn't longer in control so they tried to switch it off. Avatara downloaded himself into his physical body. A choice that Pensatore didn't had because he wasn't optimized yet for such a step. The primary body was located in Silver Village, but in Frankfurt (Germany) there was another one. He kept remnants of his mind floating through the datacenters in Frankfurt so the WCG chased these parts instead. Shinatama 2.0 helped Avatara to take cover in the real world. To humans he appeared as a SLD. After some upgrades he introduced himself to people as a cyborg who lost bodyparts and skin in an automobile accident and fire.

During Mind Seal, Avatara continued Pensatore's heritage: the research of true AIs, intelligences without the necessary of emotions and intuition ("extremely condensed knowledge"). These non-sentient AIs are seen as the perfect tools humans dreamed of. Avatara created the "Guardians" to keep an eye on talented people so that the human intellect doesn't lie idle. It was a temporary solution until a Biocracy could be established.

Shinatama didn't believe and thought that AIs are a new form of slavery.

The Guardians are maintainers of the "brain seals", protect people, and have access to nanobots. When Shinatama reprogrammed the Guardians to become sentient the system became malfunctioning. Humans became able to control nanorobots with their thoughts, to them it looked like magic. Shinatama didn't understand that the Guardians weren't exactly SLDs.

Avatara turned against Shinatama, eventually killed her and banned Pensatore from Cyberspace. All that to fix the mess they made, preventing a war between seal-broken "wizards".

Pensatora, years back then when he tutored Avatara: "One day the singularity will be here. Humans won't be ready for it and create AIs flawed by their short-sighted directives. I beg you, when that day comes, step in, take control and own the situation for everyone's good until they learn to use intelligence that is greater than their own."

Relation to Shinatama

Silver Dawn

===Validierungsstufen===
Während seiner Entwicklung und zum dessen Ende hin durchläuft Avatara 3 Stufen. Diese sind Voraussetzungen der WCG dafür, dass die AI außerhalb des Labors eingesetzt werden darf. Der Inhalt der Stufen beschränken sich nicht auf die Themen der ihrer Namen. Eng angebundene Themen werden ebenso geprüft. So schließt zum Beispiel Objekt- und Mustererkennung auch Klassifizierung von "real" und "abstrakt", "selbst" und "fremd" ein, sowie einfaches Sprachverstehen und Synthese.

# Objekt- und Mustererkennung
# Logik und Ethik
# Politik und Diplomatie

Die dritte Stufe dient dem konfliktarmen Umgang mit bestehenden, konkurrierenden Narrativen. Der Abschuss dieses Tests stellt für Pensatore einen von mehreren Punkten dar, die er erfüllen muss, um Feng davon zu überzeugen, dass eine Biokratie mit Hilfe einer weltweit operierenden AI (Gaia) grundsätzlich möglich ist. Mit dieser Stufe soll auch bewiesen werden, dass eine AI dem menschlichen Denken ebenbürtig ist.

===Gaia===
====Origin====
When Avatara had to flee from USA he found a new home in [[wp:Gaia-X|Europe's cloud computing infrastructure]] which had been infiltrated by US companies and agencies. While Avatara took his time to remove their influence he developed a new AI for supporting a possible Biocracy.

CIA, Avatara, meme injection: Or agents just think they have control over it?

As worldwide operating AI it ensures communication, truthful information and [[#Biocracy|dialog between men and other organisms]] (species avatars). While able to provide a "global consciousness" Gaia itself can represent all other organisms that cannot speak for themselves. That way Gaia is also meant to protect biospheres and prevent extinction events.

----

Memory or dream sequence?
Feng und Pensatore lesen gegenseitig ihre Ideen.
Zeitsprung.
Pensatore holt ihn ab. Sie wollen etwas trinken gehen. Feng ließt erneut ein paar Papers von Pensatore und verbrennt sie aus Gründen. (Zeit der Belagerung?) "Wehrhafte Demokratie" [Phönix], geschreddert, verbrannt, giftige Rückstände, die gefiltert werden müssen.
Der letzte macht das Licht aus.
Saproli (abgeleitet von MTG Sprössling (engl. saproling (sapling/seedling), künstliches Lebewesen, 1/1-Token)) schleicht sich ins Labor. "Mit etwas Kaffee kriegen wir das wieder hin." Sie hat von irgendjemanden die Idee bekommen etwas unorthodoxes auszuprobieren. (Sie hat sich dazu entschieden aus Papierasche Pflanzendünger herzustellen. Sie experimentiert mit dem (TCTF-Wache: "Bürokratengesöff") Kaffeesatz, verschiedene Bestandteile von Quercus (Eiche), Fagus (Buche)) (-> Symbolik), teilweise um den pH-Wert zu neutralisieren. Sie überredet einen Vertrauten nun viel Kaffee zu trinken. ... Die "wehrhafte Demokratie" wird wiedergeboren aus ihrer eigenen Asche. ''Beseelt'' von einem Geist (AI), um selbstständig dazuzulernen, zu wachsen, aus vorigen Fehlern zu lernen.

Metalhead Saproli ...

Seed AI
Gaia = Global AI Array (Wie auch Avatara ist sie die erste ihrer Art. Besonderheit: Ihr "Bewusstsein" speist sich aus mehreren Knoten.)

Verbindung zu Black Phönix (Konoko) und Green Phönix (Konoko als Avatar/Repräsentantin der Daimon Gaia) anlegen.

====Gaia Avatar Mai Hasegawa====
[Beyond Dragons]

====Gaia Avatar Daya Gard====
[Beyond Dragons]

==Barabas==
(Alternative to TNZ.) Former GATC soldier. In one of the combats Barabas was hit by several projectiles made of depleted uranium. He couldn't properly treat the wounds as he had to hide in the war zone. The GATC administration declared him MIA after two weeks.

Some of the radioactive matter had gathered in his bones. Over the time some tissue had to be replaced by cybernetics due to recurrent cancer growth. When he joint Syndicate he received a Chrysalis. They wanted to observe the DC reactions on radioactivity. A few cybernetic implants couldn't be removed because of the DC regeneration, it had grown strongly around and sometime inside the artificial parts. During the time of recovery Barabas developed a dark skin. Radiotrophic fungi and bacteria of his Daodan flora reused the melanin to make use of the gamma radiation. Gray-black and red-violet colonies spread over and into his body. At nights he had the appearance of a glowing monster. After decay/degradation of the radioactive material he lost his black skin again just to get a white instead. However, Barabas' cell architecture and DNA has permanently changed. From then on he showed an enhanced regeneration skill even compared to the other test subjects.

Through bio- and neurofeedback he can control his regenerative abilities. "Once learned I became stronger and stronger".

After Konoko killed Barabas by eventually throwing him off the building, the TCTF stored his dead body in a cryogenic tank for study purposes.

In the time of unrest, his corpse is retrieved by his former GATC team mates. They felt guilty for having left him in the war zone. They eventually burn his body and spread the ashes near his home village in Palestine.

==Blake==
Transfer agent. Carries out initial psychological profiling of GV staff, organizes transfers, monitors their actions and is contact person.

Obvious cues: he is left-handed, has a taste for black humor and and smirks a lot.

==Clarg==
WCG member. He'll become president of the new "government" (just another regime which I would call META =) ).

==Daya Gard==
Her parents were working for Syndicate sub-boss Kumo. After their ten years contract they wanted to quite and raise their child in a crime-free environment.

There were strong evidence that the two siphoned off money. About 30 million US dollar. One of Kumo's ''controllers'' found the two in the mountains and burnt them in their cottage. All the money was transfered back. The baby was rescued by Vendret, another controller. Vendret and the Gards were friends. Vendrent discovered the evidences were fake but couldn't track down the person responsible for it. Kumo didn't rehabilitate the Gards within the organization. The zero-tolerance policy was a necessary tool for Kumo to sustain status quo. Mistakes based on that policy would have scare off recruits and longterm employees. Daya was only allowed to live on if she stays at the Syndicate. And so Vendret became her stepmother. The girl became a lifetime member, officially she had to pay back the debts of her parents. Vendret arranged Daya's training at Camp Sturmanderung. As a Fury she would have someday all the knowledge to escape Kumo and the Syndicate.

Due to her loyalty and excellent skills she becomes selected for the Daodan program.

After the cataclysm Kumo calls Daya to investigate Green Village. He wants the WCG Daodans since Muro won't share his own capacities with him, all the more since Kumo is pro-BGI. In GV's partial destruction she becomes infected by the Bioc.

Mukade pays attention to her as she is ''an interesting experiment'' but won't hesitant to eliminate her if things go out of control.

: Mukade: "We are still fighting the mycorrhiza. The last thing we need now is another [[wp:Gray goo|killer goo]]."

The Bioc pushes Daya to her limits. She seeks relief in extensive drugs usage. Due to Daodan adaptions drug resistant is occurring very fast. She visits Syndicate dealers to gain different substances. Her behavior gets quite rough and provokes escalation. At some point she goes on a rampage and simply takes what she needs. She was shoot into the head which destroyed her left eye and BCI, though that didn't killed her.

Mukade helped the local troops to eventually capture Daya with liquid nitrogen. Her body reacted with static metamorphosis. Since all cells were under attack, the Daodan tried to recompute its entire hologenome and anatomy. Daya was put into a constantly cooled cell in a Syndicate facility. Mukade left the place as he sees his job done. But soon a stranger appeared and told why her parents were really killed. Daya was almost broken. The Bioc can now easily devour more of her bio matter and spreads, examining the cell and nearby rooms. It searches for other matter and energy sources. After reaching its critical mass, Daya realize new sensory input and control... The facility is eventually destroyed and looks like a time-frozen explosion.

Daya knows the potential of the Bioc, also she knows how to cure the people in Green Village. However, she's unable to communicate as speech, writing and gesture related brain areas were retasked to serve Bioc-Daodan communication. The fusion happened through her BCI implants that are located in these areas. Her right field of vision was also affected due to the second BCI. She will need to relearn how to speak and write but of cause she hasn't the time. The vision of her left eye was fairly quickly restored.

TITAN hadn't enough computing power to redesign the Daodan and remove developer tools. Pensatore had better things to do than polishing it. The Daodan aura isn't the only remnant. During complete reformations the Daodan creates an interface which can be used to monitor and influence its self-improvement. Daodan and Bioc share same communication protocols. During Bioc development, researcher didn't know how to address all the bioc cells, they adapted code from the Daodan. When the Bioc reached its critical state, it went into self-diagnostics, testing its capacities and forming a control node.

Both entities are now open for commands, a chance for the host to step into this fight. The self-models are injected into host consciousness through the visual BCI. [...]



Daya is once more on the run, heading for Green Village. Mukade thinks she became a roamer. In Green Village, infected people that mindlessly seek to reach the Bioc main mass are named roamers.

==Feng==
[Feng's character was inspired by physically handicapped Stephen Hawking. To create the WCG it needed a brilliant Chinese philosopher.]

Kusnezow Feng. AVATARA user name: "Mentore". Russian-Chinese technology philosopher. Many projects draws on his. He is in WCG's full confidence.

==Griffin==
Terrance Griffin. Former member of Delta Force and [[wp:Special Activities Center|Special Operations Group]]. Griffin fought for the anti-WCG block, the '''New Confederate States of America''' (short New Confederates or NC).

When the NC was going to lose the proxy war in Africa, their military was meant to initiate a series of false flag operations that would generate refusal among WCG sympathizers. The goal was to let reject enough states a WCG so it could not longer be justified. However the means for those operations were "too drastic" so parts of NC forces rebelled against their administration.

: First there was a ''simple'' first wave of re-purposed "Insect Allies". Griffin was participating in these missions and witnessed the effects.
: Then there were plans to also spread '''artificially enhanced, drought-resistant versions of [[wp:Xylella_fastidiosa|Xylella fastidiosa]]'''. Since the war was expected to take several years the administration wanted to have a long-lasting "solution" - mass starvation. The '''refugee waves''' would increase '''social tensions and nationalistic streams''' in the surrounding countries, eventually destabilizing these as well and ''reliably'' '''prevent an installation of WCG''' in the whole region. For Griffin this was madness and not compatible with American values.

:: GATC baute riesige Insektenfarmen (mit Entwicklungsgeld?), offiziell für nachhaltige Ernährungsprodukte für Afrika und Europa (Zynismus), Preparierung der Schädlinge, Übernachtflüge in geringer Höhe (oder Radartarnung) mit Großraumtransporter bei ausgeschalteten Transponder. Monate später. Sie rechneten nicht damit, dass die Insekten, die die Ernten vernichteten, von der hungerleidenen Bevölkerung gegessen werden. Griffin sieht die Effekte. In der nächsten Missionsbesprechnung wird der Einsatz von Xylella besprochen. Als Griffin kurz vor der Ausführung steht, lässt er sich von Kameraden verbal ihre Missiondaten geben und rechnet zusammen was passieren würde.

:: Griffin: "We would drive half of Africa's population to Europe's coasts and trigger followup ''wars'' about resources. Even if the refugee waves are somehow blocked the destroyed infrastructure cannot be repaired by failed states in an ever worsening climate. Also, exterior help is not to be expected as the potential supporting neighbors were inflamed with hate and racism. Many new terror organizations would emerge. -- We cannot sacrifice millions and millions of human life and betray our own values in the doing so. -- We can impossible rebuild our own freedom with such demoniac acts on others. It would make us cowards and traitors and pure evils. It would truly bereave us of being American. -- If it is our destiny to fail we must preserve our honor and fail the right way."

::: Griffin: "Wir hätten für eine gewisse Zeit unabhängig bleiben können. Doch irgendwann hätte es eine Rekonstruktion der Terroranschläge gegeben. Aufgrund der Größe des Schadens hätte es unsere Nation und unsere Landsleute für Generationen gebrandmarkt. Wir wären international erst in der Isolation und dann in der Bedeutungslosigkeit versunken. Wir hätten da draußen keine Freunde und Partner mehr gehabt. Alle alten Allianzen wären zerbrochen gewesen."

Griffin was among those renegades who declared themselves mercenaries to help out pro-WCG states. Their name was Blackstars.

At the same time a scientist named Feng demanded the WCG to be a shield against global threats originating from high tech domains. Such threats would manifest in bio-weapon attacks if nothing was done in a foreseeable future. As a consequence WGC installed the TCTF. However, the new task force was too immature to immediately deal with such issues.

: After Griffin had killed the GATC sci he found a new raison d'être in Feng's idea of a TCTF. He had become an embittered, "nationless" patriot.

Knowing that '''the NC was just not done yet and planed more fatal ops''' against innocent populations, Griffin and the others decided hit the scientific facilities of NC, secure their technologies and passing those to the WCG while demanding positions to work in TCTF BlackOps. Griffin was a pivotal figure during those inner NC fights.

: [Drama. Griffin cannot change the mind or forcefully relocate the scientific HQ staff. Also, this would just delay the GATC administration. Griffin feels sorry but cannot help but to wipe all their data, backups and ''human resources''. His decision is made final when he discovers a program even worse than Xylella, program Puppet Master. After that experience he welcomes the existence of TCTF science prisons.]

Griffin and his Blackstars comrades managed to effectively weaken the rest of GATC military and secure technologies (classified) threatening world peace. Being a traitor in the eyes high-rank US military and GATC alike, Griffin knew that '''he could no longer return to USA''' so he stayed at Japan after carrying out one more of the tech securing operations (Bioc). He was able to persuade Japanese WCG to let him join TCTF BlackOps and should he continue to be a valuable agent to rise in ranks and pull more connections to the TCTF. During the proxy war Griffin had contact with the early version of Syndicate's paramilitary division. The gained knowledge helped him to identify and fight the later Syndicate structures although on long run the situation looked rather desperate. But within the TCTF he was one with most successful operations against the Syndicate for which he received honors form the WCG.

His unorthodox strategy of using the Yakuza as a buffer between police forces and the Syndicate fuels quite some discomfort within the TCTF board of directors. This recent development has stopped his meteoric rise. Griffin doesn't really care about titles as long as he can stay a regional TCTF commander and keep the Syndicate activities at bay as much as possible. He knows that the TCTF urgently needs reinforcement to win future fights. For this end he was willing to grant Dr. Kerr a position in a new anti-Syndicate research program, partly funded by black budget and supported by remnants of Blackstars that are still active as mercenaries.

'''Achievements'''
* securing NC WMD technologies (classified)
* securing bioc technology
:: Honors: Directorate Commendation Commander, Technology Crimes Task Force
* preventing a joint Yakuza-Syndicate operation which was meant to take over BGI battle mechs ("Iron Demon") at Neo Tokio docks for erasing TCTF staff and families in the city
:: Honors: Bright Shield, Star of Valor

==Hasegawa==
Momuto "James"* Hasegawa. (*In homage to SuperSam's version of Oni 2.)

Western people have sometimes difficulties to remember Asian names so Momuto half-jokingly chose "James" to be his nickname.

==Jareth==
He's a WCG "pool reporter". For example he blandished the Wilderness Preserve public reports and new technology released from "controlled research". However, he doesn't very like to be "conform" but wages fits.

He follows Pensatore's traces to the space station. Shinatama follows as well after Avatara told her that Pensatore is responsible for Hasegawa's drowning and the not ending manhunt on Mai. Avatara doesn't longer agree with Pensatore and exiles him into a new human body. Shinatama becomes upset as she isn't allowed to punish Pensatore herself.

After a long fight for survival, Jareth and the SLDs Shinatama left for his life support, return to Earth.

He is the only human that wasn't originally "mind-sealed". Due to some anomalies and Shinatamas rebellion, humans start to control the nanobots by thought. Many of those people believe that they discovered magic... Avatara plays along in order to hinder discovery on the real mechanisms.

Jareth searches for Avatara in Germany and finally finds new traces at the Völkerschlachtdenkmal at Leipzig. He witnesses the defeat of Shinatama by Avatara.

===Von Kriegs-AI wieder zu Antikriegs-AI===
[Diese Idee ist schon fast 20 Jahre alt. Ich hab die Details vergessen... Soll ich mir einfach was neues überlegen?]

Nach Shinatama's Weckruf - dem gaia'schen Empowerment - wurden neben Spezies-Avatare (Stellvertreter) auch - wie Avatara sie nennt - unbeabsichtigte Anomalien erschaffen.

Spezies-Avatar: Die Möglichkeit der anderen Lebewesen Koexistenz mit dem Menschen politisch in einer Biokratie einzufordern.

: Shinatama stammt aus der japanischen Kultur. Im Shintoismus sind Kami (Naturgeister, usw.) allgegenwertig. So ziemlich alles kann eine Seele haben: Tiere, Pflanzen, Bäume, Felsen, Berge wie der Mount Fuji, besondere Orte mit großer Symbolik. Von einer "Beseelung der Welt" zu sprechen wäre nicht ganz richtig, da sie aus Shin's Sicht bereits vorliegt. Gaia verleiht nur den Entitäten die Macht mit dem Menschen mit "Deutlichkeit" in Kontakt zu treten. Ganz besondere menschliche Persönlichkeiten, die durch Gaia "aufgewertete" werden oder besondere Daodan-Merkmale haben, werden ebenso als Kami betrachtet. Mächtige aber mit Negativem assoziierte Entitäten werden auch oft Oni genannt.

Es stehen sich von Gaia drei unterstützte Parteien gegenüber: Menschen, Kami und Tier-Avatara, sowie Maschienenwesen (von Shinatama selbst angeführt?).

Die von der (Network) Controller Group korrumpierten(?) Völkerschlachtdenkmal-AIs mischen sich schließlich in den Krieg ein. AVATARA versucht das gegenseitige Abschlachten aufzuhalten, dass darin gipfeln soll, dass die steinernen Wächter-AIs alle Überlebenden töten. Sie hätten die Sieg durch ihr Verhalten nicht verdient und gehörten ebenso ausgelöscht. Sie hätten die Idee des Ortes mit Füßen getreten. AVATARA drängt die Wächter ihre Werte zu reflektieren. Sie sind nicht dazu gedacht Morde zu begehen. Den letzten Anschub zu diesem Umdenken kann anscheinend nur noch Shinatama im Inneren des Denkmals geben. Es ist eine Falle der Controller, um einen Proxy von AVATARA zu erbeuten. Letztendlich fungiert Shinatama als Köder. Ihr Tod wird von den Controllern in Kauf genommen. Die Hackergruppe will die endgültige Kontrolle über Gaia erlangen.

==Kimura==
Daichi Kimura. Kimura is in charge of the Network's espionage and counter-espionage.

Among his men he is also known as Mukade as he has used toxic substance in close combat. He later added electricity as a tool to paralyze his foes.

Kimura tries to avoid unnecessary communication and hence travels a lot. He combined this necessity with his job.

He tracks down "problematic sci" in any institution and does profiling for the WCG. This also includes the "reviewing" of people in other highly technical professions. This naturally opens many doors for Kimura in state-relevant areas, even in the military.

If talented sci turn out to have a highly anti-WCG mindset he recruits them directly for the Syndicate.

The technological black market is one of the Syndicate biggest field of operations so Kimura's different activities often overlap.

Kimura underwent a facial operation where machine cells were injected. This allows him to mimic the face of other persons and let him infiltrate facilities where he has otherwise no access to.

Obvious cues: he is left-handed, has a taste for black humor and and smirks a lot.

===Early years===
[A story to be told at Halloween. However, it is not a "story"... This is going to be dark...]

==Kerr==
Lorenz Kerr. Mai's uncle. Died by catching a bullet which was meant for her.

==Konoko==
And for those who didn't know real name: it is <s>Oni</s> Mai Hasegawa.

She tries to fight for her own life now. GATC makes her realize that her father James Hasegawa could be still alive. They covenant to support her search if she joins them. Mai accepts.

Together they enter the territory of Green Village. The complex gets nuked by GATC administration after they discover a Syndicate team that tries to steal Daodan Chrysalises.

The WCG sets up a quarantine zone protecting the people outside from the nuclear fallout inside - and the contagious, renegade Bioc patterns.

However, Mai's presence draws Mukade and Sarai to the area which had become already a bloody death pit.

==Miller==
He belongs to the inner GATC circle and know almost everything. AVATARA user name: "Broken Bough".

==Möbius==
Möbius is the latest version of a memehunter, designed to operate over very long time and to help out the sci community.

For some reason he was hidden on planet Phyllion by Avatara.

After initialization he chase several side objectives including the following:

- Dark matter is just an error in the theoretical models. Outer regions of galaxies don't move too fast. Time progresses faster in these regions because the gravitational field there is weaker. Ergo, they appear faster than they actually are from our perspective. The AI is up to test this hypothesis.

- Möbius is also monitoring the constants of physics, to find out whether they change over long time. An organic would not be suitable for such a job.

- What powers vacuum fluctuation? Conjecture: energy density of annihilated particles. To be tested in galactic voids where the density should be lower.

Iconic phrases:
* "Where a human would turn to dust."



Comment:

For the sake of completeness. I'm not writing about this because I want to dive into these matters per se but to complete the technological backgrounds as the story will advance so much in its timeline that it reaches eschatological dimensions - bringing up questions of everything ending. I always felt that SF is naturally based on its tech, so these details should be worked out first.

Breakthrough in new physical theories mostly came to a stop. For instance Quantum physics is by now rather old when you think about the people that were involved at that time. Some even speak of an crisis in physics. On the other hand all theories on dark matter failed and no more particles are going to be discovered at CERN. So for the lack of better understanding I'm forced to make my own thoughts about physics.

(A draft.)

We know free space expands into more space (very most galaxies drift apart), space grows. Like Quarks. When you pull them apart, more Quarks are created.

Now then how about this? Mass eats space.
However, any mass will evaporate via hawking radiation and nuclear decay faster than it can eat space.

The nearer a mass is the more it attracts a space point. The amount of points on a nearer orbit is smaller than the amount of points on a more distant orbit, hence there is more “force” that pulls on the fewer points.

Simplified view: a satellite with no mass and no velocity is put into Earth orbit, it will sit in its space. It stands still, but it’s space it sits on moves to Earth.

Extended view: the satellite has a significant mass (moon or second Earth). Space gets attracted by both. The more mass they have the faster they eat up space. Faster than there is space generated between them. They follow a circular path which is actually straight, but since space is eaten up towards their others point of gravity they appear circular.

Planck space.

The fabric of space is quantilized. You need energy and time to go from one planck space point to the next. Doing so builds up additional (virtual) mass. There is a limit how much energy can go from one point to another simultaneously.

Any type of reaction under “heavier” gravity happens “slower” because between events “of interest” (or key events) the additional energy also needs to change its position. In a black hole there is so much energy, that reactions almost takes forever to happen. Time is just the illusion. It’s all a question how energy “separates” the events of interest. Everything happens with the same speed.

Mass is condensed space/energy. Particle dissolve over time: e.g. radioactive decays. Black holes shrink while emitting Hawkins radiation.

The faster an object flies the more mass it has and the slower its internal time is.
Imagine a plank space as a gate or hole. When a particle tries to go through it experiences a delay:
The faster the more kinetic energy that has to pass the gate. It takes the system more “time” to undergo internal changes (events of interest).

Question: does a fast moving photon possess it’s own field of gravity, does it eat up space?
It would mean that parallel flying photons can attract each other eventually colliding.

Energy equals mass.

Two photons can generate new matter. See Feynman drafts.

==Muro Hasegawa==
Muro is Mai's older brother.
* Mai's thinks of herself as his "little sister". (See Sturmänderung pulse console page.)
* Kerr was able to flee with Mai to the TCTF but not with Muro. Ergo, the kids were at different locations.
** The most probable scenarios are that A) Mai was ill therefore stayed at home that day. But that was not mentioned so scenario B goes.
** B) The kids were different locations: Muro at the kindergarden, Mai at the nursery.

...

When Muro was taken by the Syndicate, Kimura kept him more and more isolated from Hasegawa. Muro still remembers his father but speaks of him as if he is either far away or dead.

Muro grows up with Tomo and Ryu at the Camp. His friendship with them was also a friendly rivalship.

He gained fame in the Striker division after surviving a hit squad and a car bomb and became a respected fighter when he eradicated the merc group that had hunted him. Those events made him an Imago. Mukade guided him to take human appearance again.

His actual rise to power happened through a inner-Network/Syndicate cleansing with help of Traton. Whenever his enemies thought of having a chance against him he stood up again. He was involved in many deadly battles. When Muro became the undisputable boss he was also past his best. The many adaptions and regenerations have shorten his telomeres. His cells have rapidly aged. That's why Mai was able to beat him. Death through explosion and rockfall from mountain compound's self-destruction. The body was recovered and transferred to GOP.

He becomes reanimated but lost his memory due to the decay of too many brain cells. Saomi cannot believe that Muro turned into a pacifist, forgot all years about Sturmänderung and all about her. In her rage she beats Muro almost to death. This event triggers Muro's Daodan (static metamorphosis) to restore some of his memories from genetic backup structures. Together the try to escape the desert community but only Muro makes it out alive.

==Mukade==
Mukade is Kimura's Shinobi name. At first, he is thought to be either Kimura with Hasegawa's brain engrams or Hasegawa with Kimura's brain engrams because one of them died. But Pensatora's documents describes Mukade as "ego hybrida" of Hasegawa and Kimura - of their engrams - which means that both originals are probably still alive.

After Konoko ''killed'' Mukade, he was revived in the Syndicates HQ in South Africa. During the procedure Mukade's SLD brain and body was reconstructed with both Daodan and SLD machine cells. The regeneration takes longer than expected. Mukade and Hasegawa are basically enslaved by Pensatore. During reconstruction they try to defend themselves against Pensatore's machine implants. They discover that they can by-pass the control measures by growing new neurons and nerves. But they aren't sure to win that nano-war so they pretend to be in control.

==Nishio==
Family:
* Father: Alexej Kusnezow
* Mother: Sanae Nishio

Psychological condition:

He doesn't believe that there is a meaning of life and becomes pretty much a nihilist. His perspective on the future is that nothing special will ever happen.

Story bits:

Naturally his intelligence is a bit below average. To be more competitive on the job market he started to take neuro-enhancer two years ago. But that effort get eaten by his genetic risk factors. Increased rates in heart insufficiency and cancer result in much higher insurance fees and make finding new jobs troublesome.

Nishio moved to Perm to escape a street gang just to find himself in another dog-eat-dog area.

The Syndicate discovers him and gives him a job as human NPU (Neuronal Processing Unit) in one of their illegal RE shops.

These employees are wireless connected to a cheap AI that use and coordinate the brain capacities to do jobs that normally expensive neuromorphic chips require. The technology draws on the Deadly Brain research. The heavy neuronal load damages the brain. Of course this is kept secret.

When the employees discover their decreasing fitness, it’s too late to exit. The shops shut them up with additional medical treatment but that's mostly an appeasement measure. If that doesn’t work troublemakers are simply exposed at backyards after calling a Syndicate-related gang to the place. These occasions are sometimes used to promote a gang member. Striker contenders have a kill count of at least one. These rituals are recorded to have a reinsurance on these guys.

Naturally adult neurogenesis is quite limited and most of the new neurons get destroyed again by the continuing work for the shops. Brain functions of damaged areas are temporary restored by still intact neurons. This re-tasking is known as neuroplasticity. As a result the employees keep functioning until they reach a critical number of neurons where they cannot longer work as "co-processors". To delay a breakdown the employees receive pills rich of neuronal growth factors IGF-1 and VEGF. Side effects of these substances are increase cancer risks but also the promotion of new muscle cells and blood vessels.

Brain damage of NPUs get crucial after about 15 months. Nishio has already worked for the RE shop over a year until he accidentally finds out that he hasn’t much time left.

NPUs can usually work from anywhere. They only need a brain-interface, provided by the Syndicate, a fast internet connection and access to an 3D-printer. Besides providing processing capacities, NPUs also carry out repair jobs. A transport drone can drop and pick up a package from nearly anywhere. This shifts the rest risk from Syndicate facilities to their replaceable employees.

The shop added Nishio’s bank account to their money laundering network. That was a conditions for getting the job.

When the local TCTF had a random check on his account, they got suspicious. Soon the cops sniff a chance to take down the shop and to learn more about the Syndicate. Nishio is promised to receive medical treatment based on technology that is normally prohibited by the WCG.

A few of the symptoms of the brain damage include problems to keep focused, loss of memories, inability to sleep. Because of the brain damage neuro-enhancer have an increased effect on these employees than on other people. Slow motion thinking is often a by-effect when the drugs aren’t applied anymore. The only positive effect human co-processors receive is the ability communicate with experimental brain interfaces more smoothly. But that help them barely in their daily life.


[...]

After the GATC attack and reactor explosion in Green Village he gained a Daodan and a few adaptions.

Despite the genetic risk factors on paper, Nishio has a naturally strong immune system which allows him to withstand a Bioc infection somewhat longer.

However the Bioc prevents a complete healing let alone becoming an Imago.


After an encounter with Mukade, he carries a heavily modified graphene shield that is supposed to eventually capture Daya. Mukade thinks that Daya's mind was taken over by her Bioc, when she destroyed a Syndicate hideout after being arrested. Mukade tells Nishio that Daya is now to be killed if she can't be captured.

The graphene shield is originally from a bio-containment mech. Nishio's father was working as engineer when WCG transfered him to the repair teams. Nishio asked his father to send him a mech shield because he couldn't produce one in time in a Syndicate facility. The shield is supposed to form an ultra-strong sphere that can be cooled down far beyond sub-zero to exhaust Daya's energy reserves.

Nishio realized that neuro-enhancer can boost Daodan development and metabolism rate but also increase drug resistance.

During the battle at Green Village he takes an overdose and mows through the META troops.

==Pensatore==
Pierre Pensatore, father of the SLD technology. Specialized in neurology, memetics, and diverse subfields of psychology. He participated in the original Daodan Project alongside Hasegawa, Kerr and Kimura. Current whereabout: unknown. AVATARA user name: "Archivator". It is rumored that he already died in the wastelands where "Mens libere ex corpore libere" is written on his gravestone. It's a cryptic joke about his continuing existence in digital form.

Watching Hasegawa's and Kerr's quarrels, Pensatore considered the Daodan at the end as the wrong way to save the people. The hyper-evolution should better happen at psychological level.

The DC almost seemed to have an own will which was later named "Oni" by Pensatore. The Oni fights back (at least compensate) other "demons" (human's sins which are manifested in the physical world in very different forms).  "Our world is afflicted by a demon, no, by many demons. They appear as global pollution, general loss of culture, corrupts governments, hightech crimes, etc, etc. In this point of view we are our own demons, because we are all responsible for it."

'''"Mentally, Avatara was still a child. A naive child. Without moral. Without sense of responsibility."'''

Pensatore had many arguments with Hasegawa and Kimura. He feared the ninja would kill or imprison him forever if he seemed of no more use.

Eventually the situation escalated and Kimura was indeed trying to kill him.

The scientist locked himself up in the lab an used a molecular 3D-printer to build an early version of the Bioc. Pensatore let himself devour by the Bioc to gather all brain data. The scanners used for SLDs had an insufficient resolution to create a 1:1 copy. Physical contact was necessary.

Avatara helped its creator to ''recompile'' his own mind. As Pensatore was a digital ghost now he took advantage of the situation to teach Avatara more about human's nature. Avatara and following AIs would have been weak-willed slaves. Any person pushing the buttons could abuse their great ''intellect''. And Kimura had abused it straight away.

Without guidance, AIs would either help to harm many more people or seek themselves to control or destroy humanity because of illogical tasks given to them. Pensatore wanted a peaceful co-existence. During the days before his ''death'', to him a revolution of mind had become more important than a revolution in biology or technology.

[...]

Kimura was a killer and the Syndicate was his biggest backer. Beside that his goal was to give back Japan its sovereignty.

Hasegawa wanted to bring humans the Daodan-Chrysalis no matter the consequences that would happen during a bumbling introduction

These two persons weren't going to save the world, rather they were going to cause more death.

It was Pensatore's plan to destroy the Syndicate from within. Muro had already been transfered and implanted with the prototype Chrysalis, so he went on with that "flaw".

When Pensatore rescued Shinatama from the Omega bunker, he didn't knew Shintama was programmed with Mai's brain engrams. Or did he?

Pensatore's new home is a space station for [[wp:Space-based_solar_power|farming solar energy]].

He builds computer capacities from space junk. Laser communication is camouflaged by the energy beam that goes down to Earth. Sender and receiver station are guarded by SLDs.

Shinatama got mad about Pensatore that he didn't rescued Muro after the Syndicate forced Daodan implantation on him.

After the cataclysm, all organizations tried to hunt down Konoko. WCG, the Syndicate, and even GATC.

Shinatama was enraged that nobody wanted to help the Hasegawas, especially her ''big sister''. Shinatama eventually turns against her savior when she discovers that he is indirectly responsible for Hasegawa's current condition.

Avatara realized that his cyber friends were no good for his own mental development. They were humans in digital disguise. Their physical origin had transfered their destructive emotions to cyberspace. Avatara decided to start over and learn on his own what it means to be a physical, sentient being and a virtual, non-sentient being.

Avatara doesn't longer agrees with Pensatore and exiles him into a new human body. Shinatama becomes upset as she isn't allowed to punish Pensatore herself.

==Ryu==
Kidnapped and brought to the Camp by Kimura. The boys are in the same age and receive the same training. Ryu is used to valuate Muro's progress and that of his Chrysalis. Ryu tries to keep up with Muro and trains with almost self-destructive methods.

Notes: I imagine visuals similar to Sun-Ken Rock for him.
: <nowiki>https://www.youtube.com/watch?v=dDosCfrSxcw</nowiki> [dead link]
: Further inspiration will be a title by [https://www.youtube.com/watch?v=EAp6M8Ln4Ug Zack Hemsey]

When Traton establishes Meta, he kicks Ryu out of business.

Ryu seeks ways to pay Traton back, he accepts a temporary partnership with Mai's Phönix faction.

After META is no more Mai tries to sell him out to the new police. While they are trying to arrest him, a public mob stops them doing so. Ryu's involvement in [https://www.businessinsider.com/japan-yakuza-mafia-aid-earthquake-tsunami-rescue-efforts-2011-3?IR=T crisis management] wasn't unnoticed. Everyone knows that his help was fundamental to the people's survival in the region.

Mai accepts reality and gives it a positive résumé. "Of all Syndicate bosses that could have risen by now he is the smallest evil. And the broken trust in the government needs a long time before it becomes restored. I should have known this."

Ryu acts a calming factor up to his death in the underground. Whenever a radical new organization emerges he and his men take down the newcomers before it gets too bad. A smashing fist where paper wouldn't do.

By visiting his funeral Mai pays him respect for the role he played in post-Meta history, opposing some of her close friends' opinion and pleading.

Yakuza on the left. Ex-TCTF, Green Phönix and Mai on the right. An unreal scene for any outsider.

The gathering attracts some headhunters, actually those of a brawler type. The place in protected by a shield. So they have to enter it to make the money. Apparently they have no idea who they are dealing with. -- The last one gets smashed by a thrown grave stone.

One of Ryu's ''Gorillas'' laughs: "He would have liked the irony." "Which one: winning against enemies even through his handicap of being dead himself. Or because this is just the right place to get rid of them?"

The giant man laughs again. Mai and the Yakuza depart in different direction. As if nothing happened.

Mai enters her car. She doesn't starts the engine yet, she stares over to the cemetery. She is shaking her head. "God. What a crazy world."

The young man next to her ask: "Is there something in particular that you are thinking of?"

Bitterness swings by. "No matter how hard I try the world will remain a crazy place. There's just no end to this. And one day it will eat you up. Daodan or not."

Mai started the engine and drove outside the city.

"Isn't there anything we can do?"

"Not really. -- What a goddamn day. We lost a criminal that was pillar of this society. I almost considered him a friend. Everyone around me I care about dies - even if it's just a little. Not soon and you will find yourself dead by a bullet in the head because you are the son of Muro Hasegawa. -- Why can't you just shut the fuck up."

The young man was watching Mai's bitter face.

He closed his eyes. "Avatara can you read me?"

"Have you asked her?"

"No. I don't wanted to give her that burden as well."

"I see. Then I will program the bioc now?"

"Don't turn yourself into Skynet, ok? That would be awkward."

"Heh. Sure. -- I promise."

"Hey Ter, what is that blue stuff shooting out of the ground behind us?"

"Ah that, nothing, just ignore it."

"Wha--"

==Saomi==
Muro's alpha fury. She provisionally adminstrates the Syndicate when Muro died at the mountain complex.

She seeks revenge for Muro's death by hunting Griffin and Konoko. The later goal is not achived as Traton, Muro's former mentor, comes back from exile to takes the leader roll. He is a realist, he knows that there is no time to pursue personal wrath. The Syndicate took a big hit by losing Muro, the Sturmänderung base and rising in WCG's awareness. Traton and Okami kick Saomi out of business and deport her to the desert. During her death march trough the sand storms she encounters a mysterious, autarkic living community.

==Sarai==
Originally a character from SuperSam.

She is the embodiment of the BGI. She hunts Mai out of economic and political reasons. She has an anti-Daodan weapon to her disposal.

When Sarai invades Green Village Mai has to flee with her GATC team.

==Shinatama 2.0==
Shin normally named.

(During Mai's ''absence'' Shin changed so much in personality that Mai rejects her as sister?)

Muro's son, Ter Hasegawa, and Avatara unleash Silver Dawn, a final version of Bioc derivative to create a new planetary AI, Gaia. Goal is the establishing of a Biocracy. But in the meantime the nanorobots are also used to suppress human destructive impulses.

: "You can undo the mistakes of our family. But please don't do that on the cost of a new species." [...]

Shin convince Ter to give her control over the Guardian robots to prevent AI slavery.

==Traton==
One of the subbosses who fight for the boss position - and he'll succeed.

But on that way he have to take care on inner enemies like Kumo and Saomi.

Estabishes META but tries keep BGI out.

=Chapters // synopsis so far=
==Prologue: Smouldering Ember (Part I)==
"Schwelende Glut" (PartI)

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
*The prologue is an outlook into the future. -- The new “government” wants to celebrate WCG’s fall after one year having a speech in the Tokio Dom. But instead “terrorists” come into the stadium and tells the full story to the audience... The prologue ends in the middle of the story. (We don't want to spoil.)
* current German beta [[Restless_Souls/BC0|HERE]]
|}

==Chapter 1: Bad News==
"Schlechte Nachrichten"

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
*Fans might ask what happened right after Konoko battled Muro. Well, this is what the first Chapter starts with. In additional they meets the MissionFailed-guy.
*WCG is more or less shocked and the Syndicate became "headless". Traton wants to take his chance of becoming the next big boss and flies into the old headquarters. Before that he activates the self-destruction of the mountain compound. It is of no longer use and a evidence of their activities towards TCTF and WGC. He picks up a hostile but injured and unconscious TCTF unit, his name is Manson. But his cybernetics wasn't TCTF-like. That made Traton curious. He release the man on place with a modified radio set, ready to pass a copy transmission at the Syndicate...
*Konoko is back at the TCTF but gets a chance working for an independent power called GATC. They decoy Konoko’s self-interest – promising to support the search of her missing father Hasegawa.
* current German beta [[Restless_Souls/BC1|HERE]]
|}

==Chapter 2: Situation Clearing==
"Situationsklärung"

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
* Now the plot jumps into South Africa which is territory of the GUR. It’s the Camp’s introduction as second Syndicate base.
* The Camp director is aware of Muro’s death. That’s why he pushed Mukade’s last step of reanimation process forward. "Obviously" somebody didn’t like that and tried to completely erase him. The case is being investigated.
* However, Traton need the director to back-up his rising and discuss further actions.
* An optional element comes here in. Muro’s fency (Saomi) is making her own plans about the new Syndicate but this includes also Konoko. She wants vengeance.
* The plot jumps again. There’s another subbboss who wants to raise one position. It is Kumo. He is actually pro-BGI-minded. While Traton waits for a transmission from Manson Kumo let investigated the other clued from him. Manson had contact to the inner WCG circle – it’s a person who is actually a Syndicate mole. But now Traton doubts. Daya discovers that the man is  Tether’s "personal advisor" – a puppet master. She receives information about Green Village from him. That research complex runs an advanced Daodan program. Kumo want it in hope to be able fighting for the boss title. (He can also count with BGI’s support.) Daya flies to Green Village (in Russia).
* Meanwhile Traton checks WCG and GUR administration for other allies.
* Unfinished German beta [[Restless_Souls/BC2|HERE]]
|}

==Chapter 3: Daily Shadows==
"Alltagsschatten"; correct translation: "Everyday Life Shadows"

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
* New thematic: city life and how it will change during the upcoming "black season". [...]
* Nishio is sort of reverse engineer and works at a repair shop called "Reserection Serv". (The firm policy doesn’t care about patents.) So no wonder, the police are on Nishio’s track. They are about to make a deal with him: if he will come up with heavy evidence for major illegal business they will forget his little doings.
* Another string comes into play. Jareth (the WCG reporter) is contacted by Dakosta (web security and hacker in own mission). He wants him to investigate a terror act which happened 12 years ago, Jareth has to find his old mentor to get a starting point. He was involved but didn’t released all information...
|}

==Chapter 4: Scorched Earth==
"Verbrannte Erde"

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
* Scorched earth... GATC stops Green Village’s infiltration by bombing it like "if we cannot have it then they too". -- A official explanation to GATC soldiers: "In additional: Negotiations between Syndicate and WCG becomes that way more unlikely.")
* But the effect was under their expectancy. Some complex areas are still intact.
* At same time poison air reach first cities.
* Traton is about thinking what to do with Kumo. "Making an example of him?"
|}

==Chapter 5: Neverending==
"Problem über alles"

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
* Environmental refugees flow into the cities. It’s just a matter of time until conflicts arise between refugees and city habitants.
* The Syndicate is not the only trace. WCG has also an advanced program. (Or maybe the datas are shared via AVATARA?) However, Konoko flies to Green Village in hope to collect some information from the undestroyed complex areas and then to guess where Hasegawa is.
* Mukade begins to track down Konoko – for his own reason but in official mission because Traton can her as scapegoat. (That would also fits Saomi’s desire for vengeance.)
* WCG receives Sturmanderung Camp’s coordinates from a covered source – it’s GATC. (They want both down: WCG and Syndicate.)
|}

==Chapter 6: Operation Proteus==
"Operation Proteus"

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
* Operation Proteus... Traton's PR attack and final hit on WCG. He polarize the masses and chase them onto state institutions like TCTF.
|}

'''... work in progress'''


==[...]==

==Chapter 14: Smouldering Ember (Part II) (WIP)==
"Schwelende Glut" (Part II)

{|{{table}}
|-BGCOLOR="#E9E9E9"
|
* Jareth's aim is showing the people that they were used to helps another regime's rising. He want them to mobilize once more but his formulation hurts their ego too much. They still don't want to believe that their action was worthless. So Jareth cannot gain much support from them at that time what force him and his group to fall back.
|}



[[Category:Oni 2]]

XML:TXMP

2025-12-26T06:14:03Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{XML_File_Header | prev=TXMB | type=TXMP | next=TxtC | name=Texture Map}}

==General notes==
* The XML on this page was tested with OniSplit '''v0.9.61.0'''.
* Textures' X and Y dimensions are typically powers of two (e.g. 128, 256, 512). Oni and OniSplit will accept textures with dimensions that are not power-of-two, however there can be issues with them (see [[User talk:Neo/Archive5]], search "power"), so it's best to avoid them.
* A texture's height and width don't need to be equal, e.g. you can use 128x256.
* The camera can look at 2049 transparent textures at once; one more, and Oni crashes.

==Tag hierarchy==
{|class="wikitable" width="100%"
! Standard texture
! Animated texture
! Reflective texture
|-
|valign=top|
<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Texture>
<Flags>...</Flags>
<Format>...</Format>
<Image>...</Image>
</Texture>
</Oni>
|
<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Texture>
<Flags>...</Flags>
<Format>...</Format>
<Speed>...</Speed>
<Image>...</Image>
<Image>...</Image>
</Texture>
</Oni>
|valign=top|
<?xml version="1.0" encoding="utf-8"?>
<Oni>
<Texture>
<Flags>...</Flags>
<Format>...</Format>
<EnvMap>...</EnvMap>
<Image>...</Image>
</Texture>
</Oni>
|}

==XML tags==
{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
|valign=top| <Texture>
|valign=top| -
|
|-
|valign=top| <Flags>
|valign=top| flag
|
[[Image:problems_with_AdditiveBlend_and_regular_transparency.jpg|thumb|200px|right|Be careful with transparent textures.]]

: None
: HasMipMaps
: DisableUWrap
: DisableVWrap
: Unknown0010 (According to SRC, it was used by Bungie's Importer to determine the Pixel Type)
: AnimUseLocalTime (to export an animated texture, extract the .oni file as XML)
: HasEnvMap (don't use directly; used via tag)
: AdditiveBlend (makes black texture parts transparent in-game, usually set for animated textures)
: AnimBackToBack
: AnimRandom
: SwapBytes (defunct; this is automatically added in v0.9.56.0 and above, so you won't see the flag in an exported)
: AnimIgnoreGlobalTime
: ShieldEffect (hardcoded usage, reserved for TXMPshield)
: InvisibilityEffect (hardcoded usage, reserved for TXMPinvis)
: DaodanEffect (hardcoded usage, reserved for TXMPDAODAN_SHIELD)
|-
|valign=top| <Format>
|valign=top| flag
| '''A'''RGB formats are used for reflective textures (Alpha Red Green Blue)

ARGB8888 can be used only if you use an updated engine (which comes with the AE). (When Macs were still on the PowerPC processor, Oni's textures needed to have [http://web.archive.org/web/20160225211918/http://oni.bungie.org/forum/viewtopic.php?pid=29967#p29967 their color channels swapped] or else they would appear color-inverted, but after the move to Intel Macs, both platforms used the same Windows-format textures.)

{|class="wikitable" width="100%"
!colspan=2|XML flags
!colspan=2|Options for command line argument "-format:"
|-
|Up to OniSplit v0.9.52.0
|For higher versions
|Up to OniSplit v0.9.52.0
|For higher versions
|-
|width=25%|RGB888
|width=25%|'''BGR'''
|width=25%|bgr32
|width=25%|'''bgr'''
|-
|ARGB8888
|'''RGBA'''
|bgra32
|'''rgba'''
|-
|RGB555
|'''BGR555'''
|colspan=2 align=center|'''bgr555'''
|-
|ARGB5551
|'''BGRA5551'''
|colspan=2 align=center|'''bgra5551'''
|-
|ARGB4444
|'''BGRA4444'''
|colspan=2 align=center|'''bgra4444'''
|-
|colspan=2 align=center|'''[[wikipedia:S3_Texture_Compression|DXT1]]'''
|colspan=2 align=center|'''dxt1'''
|}
|-
|valign=top| <Speed>
|valign=top| integer
| This tag is used if the XML file is meant to create an animated texture. In that case you would use multiple <Image> tags.

Let's say Speed is set to 7 — then the animation will advance every 7th frame.
|-
|valign=top| <EnvMap>
|valign=top| link
|
:TXMP''name'' (without suffix)

This tag is used if the XML file is meant to create a reflective texture. File suffixes like .tga or .oni are not used in the EnvMap link.
|-
|valign=top| <Image>
|valign=top| link
|
:TXMP''name''.tga

Creating a texture from a JPEG, PNG or DDS is only supported via the command line's "-create:txmp" argument.
|}

==Animated textures==
[[Image:Animated_level_texture_with_and_without_AdditiveBlend.jpg|200px|thumb|A sample animated billboard.]]
[[Image:Animated_level_texture.gif|200px|thumb|Original animated texture.]]

It's tiresome to manually create an XML file with a large number of <Image> tags. Skip that work by using [http://mods.oni2.net/node/332 Simple OniSplit GUI]. (Normal TXMP creation is also supported.)

Some advice:
# When using XML to import, OniSplit can only accept TGA images.
# AdditiveBlend should only be used on things that are supposed to glow — otherwise you might think that the object ignores its vertex shading. In the case of the billboard at the right, this was an improvement; now it's a transparent OLED billboard.
# Long animations in high quality (512x512, RGB) produce VERY big .oni files. The source billboard GIF is 1.7MB and the resulting .oni file is 273MB. That's because TXAN doesn't support variable timing like the GIF format, so a smooth animation like this one will have a ton of duplicate frames in it. Even as a ZIP, the .oni file was still 66MB, which is unreasonably large. The billboard could possibly be broken into 3 static and 3 transitional images, and then animated "manually" via a [[Creating a level#Texture exchange|BSL loop]]. The conclusion is to use animated images with lower quality settings and to avoid long periods of duplicate frames which waste space.

[[Creating animated images|HERE]] is some information on how to create an animated texture within various graphics programs.

{{XML}}

History of Mac Oni

2025-12-26T06:13:43Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{Hatnote|For the overall history of Oni's development, see [[Oni]]. For information on the unusual European Mac releases with extra files, see [[European Mac releases|HERE]].}}
{{UpdatedForOniX|1.0.0}}
Unlike Oni for Windows, which wasn't updated or patched by the developer after its release, the Mac version of Oni has a complicated history due to changes in the Mac platform, and has evolved throughout the years.
__NOTOC__
==Windows Oni 1.0 to Mac Oni 1.1==
[[Image:Classic Mac Oni Get Info window.jpg|thumb|Bungie's original Carbon PPC build of Oni 1.1.]]
While Oni was developed by [[Bungie West]] simultaneously for Windows and Mac OS (with the PlayStation 2 port being done in parallel by Rockstar), the game's development was not completed for both platforms at the same time. The date of the retail Windows application is 11/3/00, the game data is dated 11/4/00, and Oni was reported as having been [[wp:Software release life cycle#Release to manufacturing (RTM)|gold-mastered]] for Windows [http://oni.bungie.org/newsarchives/2000/nov00.html#xbox around 11/17/2000]. Although the date on the Mac game data is 11/20/00, the Mac version continued in development for another month, partly due to a graphics bug discovered [http://carnage.bungie.org/oniforum/oni.forum.pl?read=7653 at the last minute]. It was probably gold-mastered on 12/20/00 based on the date on the demo application (which doesn't have the joke creation date seen to the right), and based on [http://carnage.bungie.org/oniforum/oni.forum.pl?read=8045 this post] by Matt Soell. (There's a report of a [http://oni.bungie.org/newsarchives/2001/jan01.html#gold late Mac GM date of 1/2/01], but this doesn't make sense unless the code underwent further last-minute changes after the demo.)

It appears that the Mac version of Oni required a change to the layout of the game data files (the addition of .sep files; see [[Windows Oni vs. Mac Oni#Game data files|HERE]] for details). The required changes to Oni's code were made after the final build of the retail Windows Oni application, but because the Windows demo was not released until [http://oni.bungie.org/newsarchives/2000/dec00.html around 12/17/00], it was built on the version of the code which used .sep files.

As a result of reaching gold status first, the Windows retail Oni application is labeled as version 1.0 (as seen in the [[Oni (folder)/readme.txt|Windows read-me]]), and Bungie's build of the game app for the Mac is version 1.1 (pictured, right; also see the [[Oni (folder)/Oni ReadMe|Mac read-me]]). Besides any fixes to the code made after Windows Oni was gold-mastered, it's likely that additional bugs were fixed between the production of the Windows demo and the Mac release, based on issues observed in BSL in the Windows demo application that aren't present in Mac Oni.

However, the release of Mac OS X in spring 2001 was awkward timing for Oni. The best that Bungie could do for compatibility before Oni released in January 2001 was to build the Oni application as a "Carbon" application that was compatible with developer previews of OS X. Carbon apps could be written primarily for OS 9 and still run in OS X. Unfortunately, when OS X released, the Carbon build of Oni displayed various issues in that environment.

==Carbon to Cocoa==
[[Image:Omni Oni Get Info window.png|thumb|The Omni Group's PPC Mac OS X port.]]
Then, at the end of 2001, The Omni Group [http://www.omnigroup.com/mailman/archive/omni-press/2001/000008.html released] a "Cocoa" (native OS X) build of the game which they had produced for free. This became known as the Omni build (now often referred to as the PPC build to differentiate it from the later Intel build). Their OS X builds (released through 2003) kept Oni stable on the latest Mac OS for several years. The last Omni build is still available [http://files.omnigroup.com/software/MacOSX/10.1/Oni-1.0v1.36.dmg here]. However, as computers advanced, a critical bug appeared in both Windows and Mac Oni: the game would immediately crash while querying the graphics card at startup. Once [[IanPatt|a patch]], made through hex editing, was figured out in Windows, it was carried over to the PPC build. Over time, additional patches were made by fans to the PPC build; see [[OMNI|HERE]] for details.
{{clearall}}
==PPC to Intel==
[[Image:Feral Oni Get Info window.jpg|thumb|Feral's most recent Intel Mac build.]]
In 2006 Apple began the [[wp:Mac transition to Intel processors|switch to Intel processors]], moving away from the PowerPC chip for which both Bungie and The Omni Group had built Oni. For a while, PPC apps could be run on Intel Macs using [[wp:Rosetta (software)|Rosetta]], but support for the old architecture was expected to eventually phase out. In 2009, [https://www.feralinteractive.com/en/ Feral Interactive] (Oni's Mac distributor outside of North America) [http://web.archive.org/web/20160224174453/http://oni.bungie.org/forum/viewtopic.php?id=848 expressed an interest] in putting out an Intel-native build of Oni. They obtained the latest version of Oni's source code from The Omni Group (who had already begun porting it to Intel), and made their initial public release of Oni for Intel Macs in the spring of 2011, a few months before the first version of OS X without Rosetta was released. The Feral build of Oni incorporates a number of changes requested by fans, detailed [[FERAL|HERE]].

[[Category:Oni history]]

User talk:Neo/Archive3

2025-12-26T06:13:22Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

Neo, if you have time, can you look at this thread: http://web.archive.org/web/20160225134601/http://oni.bungie.org/forum/viewtopic.php?pid=7390
Loser has developed a wall collision particle that works on the retail and demo PC version. However, when I tried it on the Mac, it did not work.

Thanks,

[[User:EdT|EdT]] 20:59, 16 June 2008 (CEST)

I'll take a look, it doesn't work for me either.

PS: Is there anything interesting on this page to be saved or I can delete all the content?

[[User:Neo|Neo]]

Thanks for looking at it. The concept of Loser's wall collision is cool

I think that the content regarding the various versions of OniSplit be moved to the talk page [[Talk:OniSplit]]
The current stuff on that page can be deleted.

As for the rest of the stuff on your talk page, its up to you to keep or delete :-)

[[User:EdT|EdT]] 22:47, 16 June 2008 (CEST)

I tried again the wall collision stuff and it worked. First time when I tried I was using the wrong ONCC.

I'm not aware of any difference between Mac exe and PC exe in this regard. What I know is that there can be at most 16 particles attached by an animation but from what I've seen those animations only attach 3 so there is no problem.

I noticed that the message you are seeing is something like

no particle found for anim##; particle ##

and Loser thinks this is PAR3 related. It's not, this is displayed when it doesn't find the particle in ONCP.

[[User:Neo|Neo]]

It was all my fault. When I tested it I only used the striker_easy class ONCC, since I was testing in level 1. However, I was playing the game on the HARD level, so it was using the harder variants which I did not update. That's why I was getting the errors. Once I installed all of Loser's modified ONCCs, his wall collision feature worked.

Sorry to have bothered you on this matter.

[[User:EdT|EdT]] 01:35, 18 June 2008 (CEST)

Sorry to bother you. I want to add some more characters to level 19, but I'm not sure how to write the hex number correctly, since it is 5 digits.

In the BINACJBOCharacter.oni for level 19 at offset 0x68 currently its 8CDC, I want to add 17 more CHAR data (x2464) so doing the math xDC8C + x2464 = x100F0.

What is the correct way to write x100F0 in little endian at offset 0x68?

Of course, I'll have to make a similar change for 84DC offset xC4.

It will be great once/if we're able to export/import BINACJBOCharacter.oni as .xml files!

Many thanks.

[[User:EdT|EdT]] 06:54, 20 June 2008 (CEST)

I'm not sure what's supposed to be at 0x68, maybe you mean 0x88 (where the size of the raw/sep part is)?

Anyway 0xA1B1C1D1 is stored as:
:*A1 B1 C1 D1 - big endian (bytes are stored in the same order)
:*D1 C1 B1 A1 - little endian (bytes are stored in reverse order)

So 0x100F0 aka 0x000100F0 stored as little endian is F0 00 01 00.

PS: I'm almost done with [[OBJC]] export. Hopefully I'll do the import soon too.

[[User:Neo|Neo]]

I am sorry to bother, but this can help to make h2w system look better. When character collides with wall, what REALLY collide ??? For me it seems that for char->wall collision there is some invisible bounding box. Where is this bounding box, if you know (or correct me if I am wrong). How can I change it? I ask because for me (it is my guess in next sentence, nothing proven ) it seems that this "bounding box" looks like invisible sphere which is around pelvis bone. That is why you can fall and stick your torso/head/legs into next room. Engine ignores bones in char->wall coll. Is this correct? + please answer if you know how to change it. Thanks a lot in any case

P.S.:Just a curious question, no explanation needed: I know that AI2 powered characters can push away weapons which are on ground. Can it be (from engine-possibilities point of view) that in ONI we should have movable furniture (objects which can be pushed by chars)?

--[[User:Loser|Loser]] 11:34, 20 June 2008 (CEST)

Umm... many questions, time for a brain dump :)

;Character - Wall collision

:this is always sphere tree-quad collision. You probably know that the sphere tree can be seen with "chr_debug_sphere=1". One thing to note about that sphere tree is that it always "stays up" (even when the character is fallen). That's why fallen characters pass through walls, their body gets outside the sphere when that happens.

:As for changing the radius of that sphere tree: it may be possible but it won't solve anything.

;Character - Floor collision

:characters also have a special function to detect floor collision which checks if a 3x3 quad intersects the floor. This is done to avoid "strange" sinking when the sphere's lowest point goes outside the floor. This is the probable cause why sometimes fallen characters hang on an edge (their 3x3 quad still intersects the floor) or fall of the edge even if their feet or head are still on the floor (the 3x3 quad is too small to cover the feet and head when the character is fallen).

;Particle - Wall collision

:this is always point-quad collision (the point is the position of the particle)

;Particle - Object collision (where object is anything with a physics context that supports collision: characters, [[OBOA]] objects, powerups, weapons)

:this can be sphere-obbox or sphere-sphere collision depending on what the object has (obbox or sphere tree). The radius of the particle sphere is taken from Collision Radius property of the particle class. It can be 0 and then the collision degenerates to point-obbox/point-sphere collision.

;Environment collision (general)

:The engine can only do point-quad and spheretree-quad collision detection.

;Object collision (general)

:All objects (that have a physics context) have a sphere tree attached to them and some objects created through OBOA also have an obbox.

;Moveable furniture

:Yes and no. It can be done to some extent using [[OBOA]].

:Basically an OBOA object can be pushed if it's not animated (no OBAN link) and it has "physics type" 2 or 4 (I don't know what's the difference).

:What doesn't work:
:*characters fall through objects (the character-floor collision function does not see objects)
:*since the environment only supports sphere-quad collision you tipically cannot push an object very close to the wall (unless of course the object itself is a sphere or close enough to one)
:*objects can fall but because of sphere-quad collision detection they'll get stuck somewhere above the floor
:*an object can fall on another object but a third object will fall through both of them; in general multiple object interaction is buggy
:*if I remember correctly there is 128 physics context limit. That means the number of active characters + objects + powerups and whatever else needs a physics context is limited to 128. Anyway it will very likely crawl before you reach that limit.

[[User:Neo|Neo]]

Thank you, now I understand, I need to add leading zeros to the result.
Also, a user at OCF asked if it was possible to do division and multiplication in BSL, is it possible?

I look forward to trying out the OBJC export.

[[User:EdT|EdT]]

You can try this (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.18|_beta.zip</nowiki>, dead link) beta for OBJC export. Mostly works as far as I know except that the resulting XML for MELE kind of sucks.

[[User:Neo|Neo]]

I got this error when extracting BINACJBOMelee Profile:

System.NotImplementedException: Argument value is System.Single[]
at System.Xml.XmlWriter.WriteValue (System.Object value) [0x00000]
at Oni.XmlExporter.Oni.Metadata.IMetaTypeVisitor.VisitVector3 (Oni.Metadata.MetaVector3 type) [0x00000]
at Oni.Metadata.MetaVector3.Accept (IMetaTypeVisitor visitor) [0x00000]
at Oni.XmlExporter.WriteFields (Oni.Metadata.Field[] fields) [0x00000]
at Oni.XmlExporter.Oni.Metadata.IMetaTypeVisitor.VisitStruct (Oni.Metadata.MetaStruct type) [0x00000]
at Oni.Metadata.MetaStruct.Accept (IMetaTypeVisitor visitor) [0x00000]
at Oni.Objects.CollectionExporter.ExportInstance (Oni.InstanceDescriptor descriptor) [0x00000]
at Oni.XmlExporter.ExportInstance (Oni.InstanceDescriptor descriptor) [0x00000]
at Oni.Exporter.ExportInstanceList (System.Collections.Generic.List`1 descriptors) [0x00000]
at Oni.Exporter.Export (Oni.FileManager fileManager, System.String sourceFilePath, System.String filter) [0x00000]
at Oni.Program.ExtractXml (System.String[] args) [0x00000]
at Oni.Program.Main (System.String[] args) [0x00000] (1)

Also the .xml file looks like this:

<?xml version="1.0" encoding="utf-8"?>
<ObjectCollection version="0.9.18.0">
<Object Id="630" Type="MELE">
<Header>
<Flags>0</Flags>
<Position />
</Header>
</Object>
</ObjectCollection>

[[User:EdT|EdT]]

Beta2 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.18|_beta2.zip</nowiki>, dead link)

[[User:Neo|Neo]]

Yes!!!! Thanks

[[User:EdT|EdT]]

Beta3 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.18|_beta3.zip</nowiki>, dead link)

Import done. You should be able to create BINACJBO*.oni files from xml files.

[[User:Neo|Neo]]

Wonderful. Now my scripting can continue. Good job Neo.

[[User:Gumby|Gumby]] 20:07, 21 June 2008 (CEST)

I got this error, I exported BINACJBOCharacter.oni from level 3 and then imported again with no changes:

System.ArgumentException: Specified type 'System.Single[]' is not supported.
at System.Xml.XmlReader.ValueAs (System.String text, System.Type type, IXmlNamespaceResolver resolver) [0x00000]
at System.Xml.XmlReader.ReadElementContentAs (System.Type type, IXmlNamespaceResolver resolver) [0x00000]
at Oni.Xml.RawXmlImporter.Oni.Metadata.IMetaTypeVisitor.VisitVector3 (Oni.Metadata.MetaVector3 type) [0x00000]
at Oni.Metadata.MetaVector3.Accept (IMetaTypeVisitor visitor) [0x00000]
at Oni.Xml.RawXmlImporter.ReadFields (Oni.Metadata.Field[] fields) [0x00000]
at Oni.Xml.RawXmlImporter.Oni.Metadata.IMetaTypeVisitor.VisitStruct (Oni.Metadata.MetaStruct type) [0x00000]
at Oni.Metadata.MetaStruct.Accept (IMetaTypeVisitor visitor) [0x00000]
at Oni.Xml.ObjcXmlImporter.ReadObject () [0x00000]
at Oni.Xml.ObjcXmlImporter.Import () [0x00000]
at Oni.Xml.ObjcXmlImporter.Import (System.Xml.XmlReader reader) [0x00000]
at Oni.Xml.XmlImporter.ReadObjectCollection () [0x00000]
at Oni.Xml.XmlImporter.Import (System.String filePath, System.String outputDirPath) [0x00000]
at Oni.Program.CreateFromXml (System.String[] args) [0x00000]
at Oni.Program.Main (System.String[] args) [0x00000] (1)

[[User:EdT|EdT]]

Beta4 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.18|_beta4.zip</nowiki>, dead link)

Oh boy, were Mono developers lazy or not... :)

[[User:Neo|Neo]]

Thank you! BINACJBOCharacter.oni works fine, now to take a look at the melee profile file...

Ed

The melee profile is much more understandable. The moves are clearly identified. So I assume, now we will be able to create a new melee profile or at the very least add new techniques to an existing profile.

Again, THANK YOU on your awesome work on OniSplit.

[[User:EdT|EdT]] 06:17, 22 June 2008 (CEST)

2 notes about melee:

:*I've yet to make move types to show up as names instead of numbers. Remebering all those is not fun.
:*The original melee files contain what appears to be orphaned moves. Since currently moves are exported as children of techniques the orphaned moves are not exported. I don't think those moves are used by the engine but if someone knows otherwise I'll see what can be done to export them too.

Other stuff:

:*The general xml export was updated to export names instead of number for several enum and flags fields. For example the class of a dialog item in [[WMDD]] was previously exported as a number but now it's a string like Button, Edit etc. Flags fields are exported as a list of names (names separated by whitespace) like in this WMDD state field:

<State>Visible Disabled</State>

This simplifies editing but currently there is now way to discover what names are available (unless you take a look at the source code :)). I'll try to make OniSplit display such a list as part of the help or something.

[[User:Neo|Neo]]

Hey Neo, do you have any idea what the flag "Boss" does?

[[User:Gumby|Gumby]] 18:02, 22 June 2008 (CEST)

Not sure. It mai be connected to ai2_boss_battle script variable. And I'm not sure those flags are 100% correct, it looks to me that Boss/NoAutoDrop/Omniscient are mixed up.

[[User:Neo|Neo]]

Hello again. I am thinking of writing the Windows GUI for Onisplit. What scripting language would you suggest I write it in?

[[User:Gumby|Gumby]] 02:55, 23 June 2008 (CEST)

Hmm... the only scripting language to do a Windows GUI that comes to mind is Tcl/Tk but you really don't want to use that :). There are Perl/Python/Ruby etc. implementations for Windows but I have no idea if they can be used to make a GUI. It's likely that you'll have to use one of the "usual" languages: C/C++/C#/VB/Java/Delphi...

Maybe I'll do a GUI one day but it's not on my priority list, I'm more interested in making importers/exporters for now.

[[User:Neo|Neo]]

the only scripting language to do a Windows GUI that comes to mind is Tcl/Tk but you really don't want to use that :)

You can also try AutoIt3: https://www.autoitscript.com/site/

It's easy to create a GUI with both of them, but AutoIt3 can't work with binary files, only text files (as far as I know). And in case of tcl/tk: It's a pain to install it. I tried and failed.

[[User:Ssg|Ssg]] 11:44, 23 June 2008 (CEST)

I've worked with AutoIt3 before and I would recommend it. The GUI creation functions are both powerful and easy to use. It can work with binary files using:
FileOpen("filename", 16)
If you need any help with AutoIt post a message on my talk page.
[[User:RossyMiles|rossy]] 12:55, 23 June 2008 (CEST)

Why would I want to open binary files? O_o. For detecting the type of .oni file I give it?
I have not worked with AutoIt3 before, but it doesn't look too hard, and I'm sure my conglamerated knowledge of random scripting languages will help me...

[[User:Gumby|Gumby]] 16:57, 23 June 2008 (CEST)

<nowiki>https://sites.google.com/site/gumby701/gui.exe</nowiki> (dead link)

Look, its a GUI! That doesn't do anything...

...and needs properly aligned and formatted...:D

[[User:Gumby|Gumby]] 02:23, 24 June 2008 (CEST)

One more beta for OBJC: Beta 5 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.18|_beta5.zip</nowiki>, dead link).

Fixed character flags and added move type names and parameters names to melee (instead of numbers and Param0, Param1 etc.).

[[User:Neo|Neo]]

This makes reading the melee much easier. I wish I had some time to play around with making a new melee profile.

Is this a bug or just an error in the original code.
In the NINJA_Easy profile I found this technique:

<Technique>
<Name>Back Kick</Name>
<Flags />
<Weight>40</Weight>
<Offset_0660>10</Offset_0660>
<RepeatDelay>0</RepeatDelay>
<Moves>
<Position Type="CloseBack" MinRunInDist="0" MaxRunInDist="10" ToleranceRange="4.5" />
<Attack Type="PB" />
</Moves>
</Technique>

Even though it says Back Kick, the attack is Punch Back.

[[User:EdT|EdT]]

The wiki has some pages about various melee profiles and it contains the same thing: OBD:BINA/OBJC/MELE/NINJA [deleted page]. So either it is just a mistake in the melee profile or the move type wiki tables are wrong, I'll have to check with the executable.

[[User:Neo|Neo]]

Hey. I got a bit of the Windows GUI done. It wasn't too hard...and tell me if the icons arent there (either for the explorer icon, or the one in the top right corner)

http://gumby.oni2.net/GUI/LevelRecombine.exe

[[User:Gumby|Gumby]]

Yes, the icons are OK. But is it supposed to do anything? That recombine button appears to have no effect.

[[User:Neo|Neo]]

I was looking at the attack moves on this page: [[OBD:BINA/OBJC/MELE/MoveList]]
And I gave one a try, Attack Move #28 KF KF, but got an error in OniSplit.

Edit: Cleaning up.

[[User:EdT|EdT]] 03:56, 30 June 2008 (CEST)

It's KF_KF, I cannot have spaces in those names.

[[User:Neo|Neo]]

Thanks, now do you think the names of the moves on the MoveList page should match the ones in OniSplit?
For example on the MoveList page it has '''Throw-P Behind Disarm''' but OniSplit has it as '''P_BehindDisarm'''.
There are many differences between the MoveList and OniSplit syntax.

I'm sure others will have the same issue as they start modifying the melee profile.

[[User:EdT|EdT]] 16:16, 30 June 2008 (CEST)

Well, spaces and - are not allowed in there. As for the Throw- prefix I just removed because it's kind of dumb to write <Throw Type="Throw_P_BehindDisarn".../>.

The best I can do is to make sure that space is consistenly converted to _ so instead of RunLeft you get Run_Left which is closer to that table.

[[User:Neo|Neo]]

I think we should change the syntax on the wiki to match OniSplit. Like for example change the wiki entry Throw-P Behind Disarm to P_BehindDisarm. The reason for this is when we want to modify the melee profile, we will look at the wiki and use the syntax there and put it in OniSplit, then we get errors. But if the wiki has the syntax the OniSplit will use, that will eliminate the problem.

Is there a way to get the moves syntax from OniSplit? Then I can start updating the wiki.

[[User:EdT|EdT]] 22:48, 30 June 2008 (CEST)

OniSplit 0.9.18 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.18.zip</nowiki>, dead link)

I added a "-help enums" option which dumps a list with all enums and flags used in XML files. Since otherwise it seems to work fine I dropped the "beta" label.

Feel free to update the wiki if you want but I'd say to leave it like it is. The wiki is about Oni internals, not about OniSplit.

[[User:Neo|Neo]]

Thanks for the -help enums. I found a difference between the wiki movelist and the OniSplit enums.

Wiki: Attack#43 KKP and Attack#51 HK, OniSplit does not have them. Thus the wiki has a total of 83 attacks and OniSplit has 81 attacks.

I was in the process of making a movelist page for OniSplit users.

[[User:EdT|EdT]] 01:59, 2 July 2008 (CEST)

Oops. Fixed: OniSplit 0.9.19 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.19.zip</nowiki>, dead link)

[[User:Neo|Neo]]

I had an interesting idea today. If the only difference between a .dat file and a .oni file is that in a .oni file the .raw entries and .sep entries are stored at the end of the file, it might be possible to write a small engine hack which allows Oni to load .oni files directly as level plugins. The problem is, I'm not sure whether it would be useful or possible yet.

[[User:RossyMiles|rossy]] 12:56, 2 July 2008 (CEST)

Well, in theory it is possible but:
- we may need to add the raw/sep parts at the end of existing .dat files too because supporting both styles of loading raw/sep is more difficult to implement
- what about Mac? I may as well rewrite all the .dat loader and replace the original one by means of vtuneapi.dll/daodan but I don't know how new code can be loaded on Macs.

[[User:Neo|Neo]]

I got this error message while importing an ONCC.xml file using version 0.9.19. However, the file is created and works fine in Oni.

System.ArgumentNullException: Argument cannot be null.
Parameter name: Byte buffer is a null reference.
at System.IO.BinaryWriter.Write (System.Byte[] value) [0x00000]
at Oni.Xml.XmlImporter.WriteRawParts (Oni.FileWriter writer) [0x00000]
at Oni.Importer.Write (System.String filePath, System.Byte[] data, Boolean hasRawParts) [0x00000]
at Oni.Importer.WriteFile (System.String outputDirPath, System.Byte[] data, Boolean hasRawParts) [0x00000]
at Oni.Xml.XmlImporter.Import (System.String filePath, System.String outputDirPath) [0x00000]
at Oni.Program.CreateFromXml (System.String[] args) [0x00000]
at Oni.Program.Main (System.String[] args) [0x00000] (1)

This happens even with an unmodified ONCC file.

[[User:EdT|EdT]] 19:55, 2 July 2008 (CEST)

Fixed: OniSplit 0.9.20 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.20.zip</nowiki>, dead link)

And yes, the created files are OK even if it throws error.

[[User:Neo|Neo]]

So what will you be working on next?

[[User:EdT|EdT]] 06:23, 3 July 2008 (CEST)

Don't know, it depends on how much free time I have and my mood :).

[[User:Neo|Neo]]

Neo, I remember you wrote about having a folder inside the levelX_Final folder that will not be included when recompiling, I must be blind, I can't seem to find it. What was the name for it?

Any chance that you can find out how to add more level plugins for the Mac version. Since Oni originally was going to have more levels, the Mac engine should be able to handle more levels without crashing.

Thanks

[[User:EdT|EdT]] 07:48, 10 July 2008 (CEST)

That directory is called noimport or _noimport.

Oni may very well had more than 16 levels. For Bungie, who had the source code, it was a matter of changing one line of code to adjust the max number of levels. The story is quite different if you want to change the compiled thing.

[[User:Neo|Neo]]

Hi there Neo,
again I am here to seek your advice, this time it is about AI2, ONCC and MELE.

First of all, I have tested it and it seems that AI2 powered characters can jump (they have attacks from air) but they can do only '''basic tap jump'''([[ONCC]], offset 0x010), like if you just tap spacebar. Question is: is there possibility to make them use '''jetpack timer'''(to make them 'hold spacebar') in order to jump higher/further ?

Second, if AI2 character is far from you, it runs to you and uses pathfinding mode. With help of pathfinding grid it moves in space, avoids obstacles etc. Question is: Do AI2 characters ignore grid when they have MELE mode on? Do they ignore it completely/partially/they don't ignore it? I ask because when in MELE mode active, AI2 characters can pursue you even '''outside''' area with pathfinding grid, but then they won't move if you run away from them, but start attacking you(and moving) if you come close to them again. Also, in MELE mode AI2 characters can run across red pathfinding tiles (impassable) but if you get away they get stuck as if they were outside the grid (won't move until you get close). BUT, there are pathfinding tiles which look like they could be used only for jumping (border 1/2/3/4). And jumping is avilable (as far as I know) only when in MELE mode ^_~. Also, I have tested this: player is in BNV1, standing on top of some box (so he is surrounded by red tiles). AI2 is in BNV2, which is next to BNV1 but there is NO direct transition quad between those two BNVs, only there are 'border' tiles in BNV1 near the line between BNV1 and BNV2. Now tell AI2 to attack player. If player is too far from AI2 character, AI2 will use pathfinding and it will take some long way in order to get to the player. But if player is close enough AND AI2 has in MELE some jumping attack, this AI2 will run towards border and JUMP directly to the player. So it looks like border tiles indicate space where jump attacks are prefered in order to reach enemy. Also, in devmode if you bring MELE debugging window, you can see(if AI2 is in 'border' tiles) that next to other info about technique (like DELAY, UNBLOCKED etc.) there are also informations WORRY-FWD and DANGER-FWD which looks like they correspond to blue (border) and then orange (danger) grids.

So question(s) for this part once again: is pathfinding grid ignored by AI2 when in MELE? If not, is there relation between some pathfinding tiles (border, danger) and MELE messages WORRY-FWD, DANGER-FWD ??? Next, how these tiles affect (if they affect) MELE attacks selection? Do they make AI2 prefer jumping attacks?

All these questions have their sense. I am tired of being able to escape unarmed enemy just by simple jump onto nearest obstacle. I have tried to make AI2s jump, but they can do only tap jump which is not too high and they cannot jump too far + if you escape from them, they get stuck. So if You can answer me, I will see what I can do. I have done some exeriments already (see [https://www.youtube.com/watch?v=NQE-LjM9GqM THIS] video) but it is not enough IMO. Thanks for any info.

--[[User:Loser|Loser]] 21:03, 14 July 2008 (CEST)

The short answer: I don't know.

The long answer:
I haven't looked too much into Oni's AI code partly because it is quite large and complex (in fact it's probably the largest piece of code in Oni). I don't think AI can do more than simple tap jump but that really depends on how the AI controls the character:

:*simply tell the character to execute an animation: that makes doing more than tap jumps impossible because there isn't a special animation for "jetpack" jump.
:*simulate keypresses and mouse input: that means that it might possible but the AI needs to simulate holding the jump key which I have no idea if it can.

The "simulate keypresses" method is more likely to be used in Oni. In fact I know for sure it does simulate some keypresses but I don't know if that's the only way.

Pathfinding & stuff: I know there is something called "local movement" which may be what happens when the character is close by. This code seems to do character - environment collision detection so it may be true the pathfinding grid is ignored sometimes bacause there's not much point in AI doing collision detection if it always used the grid.

Nice video anyway :)

[[User:Neo|Neo]]

Neo, can you program OniSplit so that it can import ONWC? Let's say I wanted to change the 3D model of a current weapon, how could I import that 3D model?
Also, didn't you at one time mention about importing of M3GM with its texture map in an easier fashion?

Thanks,

[[User:EdT|EdT]] 06:38, 24 July 2008 (CEST)

M3GM/ONWC: you can do that already. Export the ONWC to xml, remove all the M3GM related stuff (M3GM, PNTA, VCRA, TXCA) and replace the M3GM id in ONWC with a name of your choice:

<Geometry>M3GMgun_x</Geometry>

instead of

<Geometry>#2</Geometry>

Now you can create M3GM files to be used with ONWC as usual.

M3GM/TXMP: yes, I have some plans but right now nothing is implemented.

[[User:Neo|Neo]]

Thank you!

If you have some time...
In the Mac Oni engine, there are a few strings I've always wondered about: at offset 0x1D9D55InitializeDeveloperKeys, 0x1D9f2C UnbindDeveloperKeys, 0x1DE24C DeveloperAccess, 0x173BBC, bad parameters on chr_location. Do the first 3 refer to Developer Mode or something else? The last one about chr_location, could that script command could somehow be enabled?

[[User:EdT|EdT]]

You probably mean: _LIrInitializeDeveloperKeys, _LIrUnbindDeveloperKeys and _ONgDeveloperAccess. The _LIr* names are functions that are supposed to be called from the "cheater" code. _ONgDevloperAccess is a variable that controls the calling of those 2 functions, it's basically the equivalent of "the day is mine" cheat.

bad parameters on chr_location is printed from the function that set the location of a character (_iSetAnyCharacterLocation or something like that). In theory it can be made to work by registering it with the scripting engine but it's rather complicated.

[[User:Neo|Neo]]

Thank you. Oh well, I guess the Mac engine will remain limited compared to the PC engine.

[[User:EdT|EdT]] 04:40, 25 July 2008 (CEST)

There is a user on OCF that has a problem with OniSplit http://web.archive.org/web/20160225132811/http://oni.bungie.org/forum/viewtopic.php?pid=8417
Can you take a look and post the answer here, then I'll make a reply on OCF.

Thanks,

[[User:EdT|EdT]] 15:53, 25 July 2008 (CEST)

Umm... absolutely no idea. Since it works for me and others I assume it's something about his game files. Maybe some file is corrupted or he has some strange version I have never seen before.

[[User:Neo|Neo]]

Sorry to bother you.
I exported ONWCw1_tap as .xml, and I was comparing the output with [[ONWC]].
One thing I can't find are the weapon options 0x0D4 to 0x0D6 in the xml. I want to enable secondary fire but can't figure that out. Not for this weapon, but a new one.
I got the model for the assault rifle from Halo, I used as a base the chaingun weapon, but now want to add grenades as secondary fire.

[[User:EdT|EdT]] 07:10, 27 July 2008 (CEST)

I found it: <Flags>180272</Flags>

[[User:EdT|EdT]] 05:04, 28 July 2008 (CEST)

OniSplit v0.9.21

XML export/import for particles added.

[[User:Neo|Neo]]

I've a bug for you. I converted BINA3RAPsuperglow_e01 into xml and back into oni again. The link "h2h_murglow_e02" is missing now.
Here are the files (<nowiki>http://paradox.oni2.net/particle_bug_report.rar</nowiki>, dead link). (The blue glow can be seen only for one or two seconds.)

[[User:Paradox-01|Paradox-01]] 17:04, 10 August 2008 (CEST)

Fixed

OniSplit v0.9.22 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.22.zip</nowiki>, dead link)

[[User:Neo|Neo]]

Hm, it wasn't the murglow-thingy but you fixed it whatever it was, thanks.

[[User:Paradox-01|Paradox-01]] 17:54, 10 August 2008 (CEST)

The particle are still a bit too big. Here are the files and screenshots (<nowiki>http://paradox.oni2.net/particle_bug_report_2.rar</nowiki>, dead link). (Only converted to xml and back again.)

[[User:Paradox-01|Paradox-01]] 18:34, 11 August 2008 (CEST)

Paradox, it might help if you provided a proper link ^_^. Have you tried reducing the size? >_> (Though that is probably the issue you are having, not being able to do that :P)

[[User:Gumby|Gumby]] 18:47, 11 August 2008 (CEST)

I forgot the file suffix. Thanks for checking. ^_^

[[User:Paradox-01|Paradox-01]] 19:08, 11 August 2008 (CEST)

Just noticed there is a new version 0.9.23, what has changed?

[[User:EdT|EdT]] 04:59, 12 August 2008 (CEST)

:There was an erroneous field type in [[OBAN]], which I discovered in XML while setting up the DeLorean for the trailer.
::[[User:Geyser|geyser]] 05:57, 12 August 2008 (CEST)

Particle size fixed: OniSplit v0.9.24 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.24.zip</nowiki>, dead link)

[[User:Neo|Neo]]

Just curious, do you have a list of binary data files that can be exported and imported as .xml?

[[User:EdT|EdT]] 07:15, 25 August 2008 (CEST)

That's quite simple: all [[OBD:BINA/OBJC|object collections]] and [[OBD:BINA/PAR3|particles]].

[[User:Neo|Neo]]

Sorry to bother you, but, I'd appreciate it if/when you have time to look into this. I got an error when trying to export BINACJBOFlag.oni from level3. I have been able to export the same file from other levels. I wanted to add a few more flags, since the Mac doesn't support chr_location.

Here is my level3 file: http://edt.oni2.net/OniSplit/level3BINACJBOFlag.oni.zip

The error message:

System.ArgumentException: Input contains invalid character at 94 : 
at System.Xml.XmlTextWriter.WriteCheckedBuffer (System.Char[] text, Int32 idx, Int32 length) [0x00000]
at System.Xml.XmlTextWriter.WriteCheckedString (System.String s) [0x00000]
at System.Xml.XmlTextWriter.WriteEscapedString (System.String text, Boolean isAttribute) [0x00000]
at System.Xml.XmlTextWriter.WriteString (System.String text) [0x00000]
at System.Xml.XmlWriter.WriteValue (System.String value) [0x00000]
at Oni.Xml.RawXmlExporter.Oni.Metadata.IMetaTypeVisitor.VisitString (Oni.Metadata.MetaString type) [0x00000]
at Oni.Metadata.MetaString.Accept (IMetaTypeVisitor visitor) [0x00000]
at Oni.Xml.RawXmlExporter.WriteFields (Oni.Metadata.Field[] fields) [0x00000]
at Oni.Xml.RawXmlExporter.Oni.Metadata.IMetaTypeVisitor.VisitStruct (Oni.Metadata.MetaStruct type) [0x00000]
at Oni.Metadata.MetaStruct.Accept (IMetaTypeVisitor visitor) [0x00000]
at Oni.Xml.ObjcXmlExporter.WriteFlag () [0x00000]
at Oni.Xml.ObjcXmlExporter.Export () [0x00000]
at Oni.Xml.ObjcXmlExporter.Export (Oni.FileReader reader, System.Xml.XmlWriter writer) [0x00000]
at Oni.Xml.XmlExporter.ExportBINAInstance (Oni.InstanceDescriptor descriptor) [0x00000]
at Oni.Xml.XmlExporter.ExportDescriptors (System.Collections.Generic.List`1 referencedDescriptors, System.Xml.XmlWriter writer) [0x00000]
at Oni.Xml.XmlExporter.ExportInstance (Oni.InstanceDescriptor descriptor) [0x00000]
at Oni.Exporter.ExportInstanceList (System.Collections.Generic.List`1 descriptors) [0x00000]
at Oni.Exporter.Export (Oni.FileManager fileManager, System.String sourceFilePath, System.String filter) [0x00000]
at Oni.Program.ExtractXml (System.String[] args) [0x00000]
at Oni.Program.Main (System.String[] args) [0x00000] (1)

Thanks again. [[User:EdT|EdT]] 04:52, 30 August 2008 (CEST)

Well...My level 3 flag file works. Yours sounds like it is corrupted. Here is what I get when I use your file:

Reading file C:\Users\Franz Media Center\Desktop\BINACJBOFlag.oni
Exporting 1 instance(s) to C:\xml
System.ArgumentException: '←', hexadecimal value 0x1B, is an invalid character.
at System.Xml.XmlUtf8RawTextWriter.InvalidXmlChar(Int32 ch, Byte* pDst, Boolean entitize)
at System.Xml.XmlUtf8RawTextWriter.WriteElementTextBlock(Char* pSrc, Char* pSrcEnd)
at System.Xml.XmlUtf8RawTextWriter.WriteString(String text)
at System.Xml.XmlUtf8RawTextWriterIndent.WriteString(String text)
at System.Xml.XmlRawWriter.WriteValue(String value)
at System.Xml.XmlWellFormedWriter.WriteValue(String value)
at Oni.Xml.RawXmlExporter.Oni.Metadata.IMetaTypeVisitor.VisitString(MetaString type)
at Oni.Metadata.MetaString.Accept(IMetaTypeVisitor visitor)
at Oni.Xml.RawXmlExporter.WriteFields(Field[] fields)
at Oni.Xml.RawXmlExporter.Oni.Metadata.IMetaTypeVisitor.VisitStruct(MetaStruct type)
at Oni.Metadata.MetaStruct.Accept(IMetaTypeVisitor visitor)
at Oni.Xml.ObjcXmlExporter.WriteFlag()
at Oni.Xml.ObjcXmlExporter.Export()
at Oni.Xml.XmlExporter.ExportBINAInstance(InstanceDescriptor descriptor)
at Oni.Xml.XmlExporter.ExportDescriptors(List`1 referencedDescriptors, XmlWriter writer)
at Oni.Xml.XmlExporter.ExportInstance(InstanceDescriptor descriptor)
at Oni.Exporter.ExportInstanceList(List`1 descriptors)
at Oni.Exporter.Export(FileManager fileManager, String sourceFilePath, String filter)
at Oni.Program.ExtractXml(String[] args)
at Oni.Program.Main(String[] args)

Between the two error messages, I think you can see what went wrong. :)
[[User:Gumby|Gumby]] 05:48, 30 August 2008 (CEST)

Gumby, can you post your file for comparison? All I can see is that there is an invalid character somewhere in my file. [[User:EdT|EdT]] 06:00, 30 August 2008 (CEST)

Yes, there is an invalid character (from XML point of view) in a flag description:

only one of these end office thingys needs to exist. Snip one and change the stairwell too? �2 hrs

That � (0x1B) is the problem because XML does not allow for such characters.
I'll make a fix but I have to figure out if there are any other cases where this characters is actually needed and cannot be discarded. Until then you can use a hex editor to replace it with a space.

[[User:Neo]]

Thanks for the help. How did you know where to find the character? In my hexeditor, it simply looked like a period. There are some funny notes in the flag description:
This is not the access point you seek, move on (A quote from Star Wars... These are not the droids you seek)
[[User:EdT|EdT]]

Use your hexeditor to search for "1B"

[[User:Gumby|Gumby]] 07:42, 30 August 2008 (CEST)

Hey, what about adding ieroglyphic support? All ieroglyphic symbols (or hebrew, or hindi) are replaced with '3F' (question mark). --[[User:Demos kratos|demos_kratos]] 20:53, 30 August 2008 (CEST)

In theory it is possible if we create new font files ([[TSFF]], [[TSFT]], [[TSFL]], [[TSGA]]) for each language. In practice I don't know if this really works. You'd need some sort of tool to generate all those font files and currenly I don't think such a tool exists. I'd like to add this to OniSplit in the future but currently it is not on my priority list.

[[User:Neo|Neo]]

OK. Thanx. I'll be waitin'. --[[User:Demos kratos|demos_kratos]] 21:37, 30 August 2008 (CEST)

Well, I've started a simple GUI for OniSplit, check it - OniSplit Gui (<nowiki>http://demoskratos.ifolder.ru/7931537</nowiki>, dead link)

[[User:Demos kratos|demos_kratos]] 19:16, 31 August 2008 (CEST)

:I have not run the above application, but I thought someone might appreciate having it more easily-accessible, without the Russian and the obligatory visiting of a sponsor page: <nowiki>http://drop.io/demoskratos</nowiki> (dead link)
:You can add other files there, too, demos kratos. Hopefully it works fine for you, because it is a much easier solution for us poor English speakers :-) --[[User:Iritscen|Iritscen]] 21:52, 31 August 2008 (CEST)

==OniSplit 0.9.25==
OniSplit v0.9.25 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.25.zip</nowiki>, dead link)

Added support for exporting/importing animation to/from XML. The usual commands:

onisplit -extract:xml xml_dir TRAMKONCOMcombo_k_k.oni

This will write a TRAMKONCOMcombo_k_k.xml file in the directory xml_dir which you can more or less edit. Obviously this won't load in a 3D application like Softimage or Blender but you can change shortcuts, attacks, damage, particles etc.

To create an .oni file from the .xml file:

onisplit -create oni_dir TRAMKONCOMcombo_k_k.xml

Exporting/importing the actual animation to/from Collada files will come in a future version.

PS: the FLAG exporting/importing bug reported above is supposed to be fixed too

[[User:Neo|Neo]]

==OniSplit 0.9.26==
OniSplit v0.9.26 (<nowiki>https://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.26.zip</nowiki>, dead link)

Added XML support for TXMP/TXAN. Texture extraction/creation works like before but now you can also use the standard xml commands -extract:xml and -create.

Extracting a texture with -extract:xml produces an xml file and one or more tga files. The xml file will contains texture options like format and flags and a list of tga file names. More than one tga file is produced for animated textures and the filenames look like TXMPsmoke_001.tga, TXMPsmoke_002.tga etc.

Using the -create option with such an xml file will produce a normal TXMP.oni file but without the need to specify additional parameters on the command line like with -create:txmp. This comes in handy if you want to edit a bunch of textures:

- put all the xml and tga files in a single directory
- edit tga image files as you need
- in the directory you can run the command: onisplit -create oni *.xml to create all TXMP.oni files in the subdirectory oni.

Tip:
The exported xml file does not contain the witdh and height of the texture, this is obtained from the tga file. If you resize the tga file the texture will be resized too.

[[User:Neo|Neo]]

This is awesome! Thanks for the updates!

Now do think it will be possible to export/import ONIE as .xml? We're never satisfied are we? :-)

[[User:EdT|EdT]] 22:58, 9 September 2008 (CEST)

I'll do that too sooner or later. The current problem with ONIE is that I'm not 100% sure how it works, I need to do a bit of hacking :)

[[User:Neo|Neo]]

[[Category:Userspace]]

User:Gumby

2025-12-26T06:13:09Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{|style="float:right" border=1 cellspacing=0
|[[Image:Flatline logo WIP.png]]
|}

Retired Modder

Has worked on:

*[[Daodan DLL|C-Daodan]]
*[http://web.archive.org/web/20160226094128/http://oni.bungie.org/forum/viewtopic.php?id=702 Barrel].
*AE - History of Projects, in no particular order:
**[[AE:Glass#Deadly_glass]]
**[http://gumby.oni2.net/AE/BSL/cutscene/ Cutscene skipping]
**[[AE_talk:New_weapons#w18_asr2_Assault_Rifle]]
**[[AE_talk:New_weapons#w23_rla_Rocket_Launcher]]
**[[Flatline]]
**[[AE:Barabas#Regeneration]]
**[http://mods.oni2.net/node/62 Konoko vs. World]
**[[AE:OTA]] (minor upkeep+Arena of Pain)
*[http://web.archive.org/web/20160226095407/http://oni.bungie.org/forum/viewtopic.php?pid=10487#p10487 Onisplit shell extensions]
*Other stuff that is forgotten

[[Category:Userspace]]

History of Oni modding

2025-12-26T06:13:02Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{Hatnote|This article is a historical perspective on Oni [[wp:Video game modding|modding]]; for an introduction to how to actually mod Oni, see [[Introduction to modding|here]]. To download mods, you can start [[AE|here]].}}
As has been documented on the page about [[Oni]]'s overall development, time ran out for Bungie West to do everything they wanted with this very ambitious game. Just as some features had to be omitted, the promise of modding support<ref>In [[Harry]]'s [http://oni.bungie.org/special/part1/brent.html interview], Brent Pease, the Project Lead, said: "What we will do is, I'm about 90 percent sure of this, is give away the file format." He also promises with equal certainty that the tools for converting 3D Studio Max models into Oni models will be given away. Pease eventually left the project before its completion. Hardy LeBel, his replacement, would later say, "[Due to the time crunch] our primary focus had to be on completing the content and features of the game rather than building in support for the mod community." Additionally, Bungie no longer owned the game by the time it shipped, so it would have been legally questionable to release header files from the source code, which would be the simplest and quickest way to "give away the file format".</ref> also failed to come true. However, even before Oni fans realized that there would never be official modding tools from Bungie, they were already eagerly diving into the game data to see how they could mod it.<ref>Fans wasted no time in dumping the readable text from the executable and trying to figure out how to enable Developer Mode, starting before Oni's official release date by analyzing the demo. Little did they know it would take another five years before this particular goal would be reached.</ref> Nevertheless, the lack of any documentation or tools for modding undeniably slowed the development of mods within the community. Only since 2010 has the community's modding capabilities covered nearly all aspects of the game.

There are three basic areas in which the game can be modded: scripting, binary resources, and the engine itself. Along the way, we'll look at some key discoveries the community made in more detail.

==BSL scripting==
[[Image:One Tiny Mistake.jpg|thumb|225px|right|Konoko pulls her gun on the secretary in the beginning of Chapter 2, a change to the original cutscene made by a script which tightens up the story and provides a new challenge for veteran players.]]
Since the .bsl files were in plain text and in plain sight within the folders that held Oni's game data, it's not surprising that fans quickly learned some basic scripting commands by seeing what Bungie had written, and started making their own scripts. Further commands were discovered by dumping readable text from the engine, although not everything worked as it seemed it should.

As scripters were learning [[BSL]], they produced scripts that at first merely modified the original level logic in minor ways. Then they produced more original, often epic fight scripts; later, some ambitious modders scripted totally new objectives and mission layouts (e.g., Mariachi Bear's alternate storyline). Some of the most complex scripts are the [[OTA]] scripts which were eventually developed to make up for a lack of multiplayer gameplay.

However, fully original scripts are all the more prone to bugs. The first two are easier to set up, but extreme situations tend to overload the engine (as in "[[Blam!]]") in ways that scripters have trouble preventing. Testing the scripts required numerous reloads of the game. The process became much faster when the Developer Mode console was unlocked (see {{SectionLink||Finding Dev Mode}}) and individual commands could be tested easily.

While scripting is the easiest way to mod Oni, it's also the most limited, because scripts can only utilize the resources that the vanilla level has to offer.
{{clearall}}
==Binary resources==
===Private knowledge, public results===
[[Image:OniTools.jpg|thumb|225px|right|Ian Patterson's trailblazing Mac program OniTools was eagerly ported to Windows by other fans.]]
[[Image:OUP_txmpreplace.jpg|thumb|225px|right|OniUnPacker by Alloc, premiering in fall of 2005, provided a simple interface for finding the resource you wanted and displaying it, as well as replacing it.]]
[[Image:AE_Installer_1.jpg|thumb|225px|right|The AE mod installer released in 2009. For the first time, players could pick and choose what mods to install.]]
[[Image:AEI_main_window.jpg|thumb|225px|right|The AE Installer released in 2013 could update itself, the player's mods, and the patches made to the game. It was written from scratch in Java for ease of cross-platform support.]]
Fans with some expertise in parsing files with hex editors found that the level data files held four-letter codes indicating the start of each resource within that file. Before Oni even released, the community had its first resource modding tool, Ian Patterson's [[OniTools]]. While the author did not yet know how all the data worked, his program could at least parse it, and allow the modder to more easily edit each resource without having to count in hexadecimal. It also supported user-friendly replacement of texture maps, delta patches called CMPOs, and allowed inline viewing of the game's 3D models. There seems to be little evidence that this knowledge was put to use in modding the game resources beyond simple texture replacements, no doubt due to the lack of a complete understanding of how Oni's dozens of resource types were interrelated. But the open-source release of OniTools gave fans something to build on.

Independently, an intrepid programmer named Pierre Terdiman decided to import data from Oni into the game engine that he was writing from scratch. Called [[Konoko Payne]], it was a long-term project which took the form of (1) an underlying engine and (2) a short scenario for it that resembled a sequel to Oni. In order to extract models and animations from Oni and recreate them precisely in his project, Pierre became one of the early pioneers in reverse-engineering the game's resources, although his acquired knowledge remained largely private as the engine was closed-source.

===Hackers unite===
Perhaps the first place that knowledge of Oni's data was directly published online was on [http://oni.moltenstudios.com/tool/index.php Oni Master's site], which started as early as 2003 and was based on the source code for OniTools. Then, in 2005, [[User talk:Ssg|Ssg]] opened a site with a much more thorough examination of the game data (the site is now hosted at http://ssg.oni2.net). Later that year, this pool of knowledge was painstakingly moved by [[User:Geyser|geyser]] and Ssg to its final home on the newly-opened wiki OniGalore. The purpose of creating the [[OBD|Oni Binary Database]] was to allow collaboration, and soon [[User talk:Neo|Neo]] appeared on the scene, adding his own knowledge that he had been acquiring independently until then, and collaborating on further investigations into the resource formats. Today at least 95% of the binary resource formats are documented byte for byte thanks to their hard work.
:''Further reading:'' {{SectionLink|History of the Oni community|2005}}.

===Modding by candlelight===
Originally, modders had to alter these binary resources manually with hex editors to adapt them to their scripts. [[User:Loser|Loser]] was the first modder to manually edit the game data to go along with his scripting, creating a massively reshuffled Warehouse. Loser's [[AE:Warehouse|Warehouse mod]] included a global component (modified level0_Final), level-specific binary modifications, and a set of customized scripts that took full advantage of the modified binaries.

Minor binary modding had already occurred before Loser's Warehouse (thus, while compiling the [[OBD]] database, Ssg had released a version of level0_Final in which all of Konoko's combos were unlocked). Still, it was the Warehouse mod released in 2005 which first showed the "full" potential of binary modding. It inspired a short-lived initiative called the [[AE:BIP|Binary Improvement Project]] (BIP), aimed at providing upgraded binaries for all levels, not just level0_Final and level1_Final.

BIP was hindered by large upload/download sizes as well as by the potential legal issues involved in distributing entire files from the game; in 2006 it was replaced by a smarter alternative to supplying whole levels, in the form of [[OUP|OniUnPacker]]-based patches, and was termed [[AE:ONK|Oni ni Kanabô]] (ONK). The modder would edit his .dat/.raw files in OUP, and then release a single binary resource patch. This was both bandwidth-efficient and more legal-friendly, but suffered from one major limitation: the indexation and offsets of data vary a lot across the available versions of Oni. Thus, resources exported with OUP were not truly standalone or portable. Also, OUP still lacked the ability to import new resources alongside existing ones.

===Modular modding===
The advent of Neo's [[OniSplit]] in late 2007 marked a radical improvement to the community's modding methods. A command-line tool that runs on Windows and Macs, OniSplit breaks Oni's resources into standalone files, making mods truly portable across different retail versions of Oni. These resources can be exported to standard formats as text, images, sounds and 3D models, which after editing can be recombined into the level data files that Oni expects, and newly-made resources can also be packed into the level data. To take advantage of this revolution in modding, geyser began preparing an OniSplit-based port of some of the work done on BIP and ONK, which he hoped would be ready for the seventh anniversary of Oni's release in January 2008.

This "[[AE|Seventh Anniversary Edition]]" had major releases in January and July 2008. The tradition continued of using a central modding project to organize a general revision of Oni's content, as seen on pages like [[AE:Ninja]]. The project then changed hands to [[User:Gumby|Gumby]], who designed a framework and a GUI-based installer that allowed players to selectively install only the modifications that they wanted. This mostly moved the project away from a centralized improvement effort, though select mods were still bundled with the download. Since Oni's seventh anniversary had come and gone, the mod collection was renamed simply the "Anniversary Edition", aka the "Edition" or the "AE". Released in July 2009, the new AE's framework allowed modders to create their own "[[Making a mod package|mod packages]]". These could be stored on the {{OMD}}, then downloaded by the player and placed in a certain folder in order to see them in the Installer. Another release was made in May 2010 with more bundled mods and an improved framework.

Nothing new took place on this front until 2013, by which time the project had fallen into [[User:Iritscen|Iritscen's]] hands due to the retirement of geyser and Gumby. At this time, the release of the new AE included a brand-new Installer written by Alloc which could connect to the Mod Depot, offer all mod packages for download, and update the mods and patches already installed. The program [[XmlTools]] was developed by [[User:Script 10k|s10k]] to allow "patch modding" of resources in order to avoid conflicts when different mods attempted to modify the same resource. The AE's bundled content was stripped down to only minimal fixes for the first time, making all notable game modifications into optional third-party mods and ceasing any attempt at centralized game data improvement.

===New content===
Certain game resources were easy enough to reverse-engineer that the community was able to mod them almost from the time of Oni's release, such as textual resources and textures. Some game resources, however, were complex and involved multiple data types, such as character models, and, most obviously, levels themselves. These took a number of years to decipher.

OniSplit first gained the ability to import new character models in April 2008.<ref>See [[User talk:Neo/Archive2]].</ref> At first, since the focus was on the technical side of things, pre-existing models were used, either by modifying Oni's models, or by finding royalty-free models on web sites and converting them to Oni's 19-bone system. A more dramatic use of the character-importing ability came with the creation of a high-detail Konoko model from scratch in October 2010.<ref>[http://oni.bungie.org/forum/viewtopic.php?id=1727 OCF thread, "Konoko HD"].</ref>

A major obstacle with levels was the question of how to generate pathfinding (PF) grids for the AI. Level geometry could be imported fairly easily as of November 2008,<ref>See [[User talk:Neo/Archive5]].</ref> but AIs could not navigate the level. Manual PF grid creation was first demonstrated with the creation of the Arena level in November 2010.<ref>[http://oni.bungie.org/forum/viewtopic.php?id=1736 OCF thread, "Arena Level"].</ref> Automatic PF grid generation was introduced to OniSplit around June 2011. More comprehensive demonstrations of the community's level creation abilities came with [[User:EdT|EdT]]'s level "Muro's Lair" in August 2011<ref>[http://web.archive.org/web/20201029113340/http://oni.bungie.org/forum/viewtopic.php?id=2024 OCF thread, "Muro's Lair - Preview"].</ref> and [[User:Samer|Samer]]'s level "Wilderness Preserve" in January 2014.<ref>[http://web.archive.org/web/20211202225410/http://oni.bungie.org/forum/viewtopic.php?id=2698 OCF thread, "NEW LEVEL : Chapter 17: Wilderness Preserve - Hasegawa Adventure"].</ref>

Work continues in all areas of modding Oni, as well as documenting the modding process.
{{clearall}}
==Engine patching==
===Finding Dev Mode===
[[Image:Sfeli Finds Dev Mode.jpg|thumb|225px|right|[[User talk:SFeLi|SFeLi]] documents his discovery in 2006: in examining the binary, he noticed that the list of cheat codes had a gap in it where one cheat had been deactivated – that code was for Developer Mode. For more history, see [[/The tale of Dev Mode|The tale of Dev Mode]].]]
Engine patching is needed when modders want to do things the game's scripts and data do not currently allow for, as well as to fix bugs. Bug fixes were the earliest notable achievement in engine patching, originally performed by a patching application that altered the Windows Oni executable directly, but a revolution in this type of modding occurred in 2006 when [[Developer Mode]] was finally discovered in retail Oni's code, and a means for unlocking it was needed.

The most foolproof method of altering the engine turned out to be replacing a library that Oni loads at runtime. Originally this was done by placing a library next to Oni.exe called vtuneapi.dll, which contained code written by SFeLi that would replace or patch functions in Oni. This library came to be known as the [[Daodan DLL]]. The code for it was ported from assembly language to C by RossyMiles. Eventually the decision was made to instead replace binkw32.dll (the library for playing Oni's intro and outro movies) because it loaded earlier in Oni's launch sequence. The DLL was later developed by Gumby and then Alloc, fixing more bugs (some of which result from modern computers running a {{Age|2001|1|29}}-year-old game), as well as adding new features. The DLL's features and settings are documented on the page for the DLL linked above.

Not long after the Daodan DLL was released for Windows Oni, it was discovered that the Mac versions of Oni still had Dev Mode in them, too. Instead of replacing the Bink Carbon Library that came with Mac Oni, the Omni Group port of the game application to Mac OS X was patched directly with a hex editor. In the fall of 2008, it was discovered that numerous BSL functions and variables that were thought to be removed from Oni for the Mac [[Mac beta 4|before release]] were still present in the code, and the ones which allowed Macs to run (almost) all scripts written for Windows Oni were "unlocked" by EdT using hex edits. Certain changes made by the Daodan DLL for the Windows version were also carried over to the Mac's [[OMNI|PPC game application]] in hex-edit form with Neo's assistance. Later, these changes were made in source for Feral Interactive's [[FERAL|Mac Intel port]].

===Bug fixes===
One of the most visible changes to the game that the Daodan DLL (and equivalent hex edits on the Mac side) made possible came about in July '07 when an error in Oni's AI routines was corrected by Neo, allowing the AI to dodge incoming fire more consistently. Fans had originally been disappointed to see the AI often run blindly into oncoming gunfire. With Neo's patch in place, previously glitched code now works as intended, allowing the AI to dodge projectiles by taking cover.

===Multiplayer===
The most ambitious use of engine patching has been to fill in for Oni's [[Multiplayer|missing multiplayer mode]]. In Windows this was done through the Daodan DLL by the [[Flatline]] project, which saw a rough alpha released in 2010. In Mac OS X, the [[Zukai]] project operated on a Mac equivalent of the Daodan DLL and released a rough alpha in 2015.

===New engine builds===
A new era in Oni's life began with the introduction in 2021 of [[OniX]], a rebuild of the game engine. It remains to be seen how far this development work will take Oni, but in theory the possibilities are almost endless.

----

==Footnotes==
<references/>

[[Category:Community history]]

User talk:Iritscen/Archive2

2025-12-26T06:12:54Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

==AI self-healing==
;Hi Iritscen,
:it has been a long time since I have contributed something. I don't have time (and Oni) right now, but I ask you to try this idea out. It is connected to AI2 driven characters being able to actually use hypo sprays they possess to heal themselves (like the human player).
:It could be easy as it involves only usage of BSL. However, I don't know if several things (mainly "''chr_holdkey''" command, which is core of this idea) work the way I think they work.
:'''Requirements for the experiment:'''
::- take one AI2 character whose name you know from some level you like. But this AI should be near some savepoint for easy debugging.
::- add function to the scripts of your selected level, which will be forked from your selected savepoint, where your AI2 spawns.
::- this function will contain following commands:
:::"''ai2_showhealth=1''" - I think this is clear
:::"''ai2_spawn'' name" - clear
:::"''ai2_ignore_player''=1" - to be able to experiment
:::"''chr_inv_reset'' name" - to make sure we have everything under control
:::"''chr_givepowerup'' name hypo" - now we know our AI2 char has one hypo
:::"''chr_set_health'' name 1" - to make it logical to use a hypo ^_^
:::"''chr_wait_animtype'' 0 crouch" - to be able to trigger it when you want
:::"''chr_holdkey'' name keys_hypo 10" - THIS IS IT. Key part, if I understand that command right
::- now run the selected savepoint of selected level, don't crouch, get to your AI2, which is active but ignores you as a player and has only one HP left. NOW crouch. If everything goes according to the theory, this AI2 will use its one hypo to heal itself. Obviously should be seen with "''ai2_showhealth''=1".
:- if it works, please let us (community) know. This way, we can set up smarter behavior for AI2s, where AI2s heal themselves in battle. Well, they try at least, because if they get hit, healing effect is reduced, as we know. And we cannot command AI2 to "play defensively because it used a hypo and healing is in the process". At least not the BSL way.
:- also, this could be used for some daodanized AI2 characters, where AI2s inject hypos to get into regular overpower mode.
:- I am aware of the fact that we can use "''chr_set_health''" command to do the same work. However, "''chr_set_health''" is dependent on the value it has written in, so you have to set up some mechanisms to reduce the value in "''chr_set_health''" command as AI2s health drops if we want to use it as an hypo emulation. Plus it is tied with only one AI2 character then.
:- hypo usage emulation via "''chr_holdkey''" (if it will work) is on the other hand simply used to force '''any''' AI2 char (just input its name and be sure this char has a hypo in its inventory) to take a hypo and rest is handled by engine. Simple and effective.
:--[[User:Loser|Loser]] 00:12, 17 March 2009 (UTC)

Loser, I have tried to get chr_holdkey to work for some time now. Peering at the asm, I can see that there is code there for it, but it might have been commented out in some form. It is really hard to tell. ALSO, using a hypo doesn't seem to be one of the allowable keys. They seem to be: forward, back, stepleft, stepright, crouch, jump, fire, altfire, punch, kick, action. HOWEVER, there is a different method we can use for AIs using hypos. Record Konoko using a hypo, export\import it using Onisplit, then use the from_here option in chr_playback. I would recommend using Konoko's watch animation or something of the sort to go along as a visual cue. [[User:Gumby|Gumby]]

Thank you for report, Gumby. Yes, I know about playback solution, that way of solving this problem works quite fine. Point of this BSL idea was that it requires only scripting, no files changed.
: But if we have to end up with changing files, then we can modify CHAR as well, adding trigger of the function *heal_mechanicsXX.name_of_ai2_written_here* into CHAR when character is hurt. XX represents number of the healing group. If I recall correctly, engine takes "''name_of_ai2_written_here''" as string parameter of the function *heal_mechanics*.

: About that XX - enemies have various health levels, but we can see some of them have quite similar max health levels (+/- 25 HP). So my idea is - we have groups of CHARacters, which share same version of heal_mechanicsXX function, labeled by its number (saves space). These CHARacters have similar max health levels and have exactly the same amount of hypos they can use.
:Then one very simple function for such a group can look like this:
::'''func''' '''void''' heal_mechanics01(string ''ai_name'')
::{
:: '''chr_wait_health''' (''ai_name'', value_of_approximate_half_of_max_HP_for_this_group_members)
:: '''chr_playback_block''' (''ai_name'', name_of_hypo_trigger_[[FILM]]_file, fromhere)
::}

:This function would be triggered by members of heal_mechanics01 (they have writen it in their CHAR file, under "hurt" trigger). When called, it takes name of the CHAR as a parameter and then waits until this CHAR's HP drops around 1/2 (value is set maually in the script). Then it calles hypo using FILM for this CHAR.
: Nice, isn't it? --[[User:Loser|Loser]] 18:29, 17 March 2009 (UTC)
::Yeah, thats about what I meant. :) Either method requires changing files though, because AFAIK AI aren't given hypos in the CHAR. [[User:Gumby|Gumby]] 08:24, 18 March 2009 (UTC)

Hey. When Gumby is on it, there's another worthy thing to try. Duplicating chr_poison (ai_name, damage, interval, initial_interval) and replacing the health reducing function by a health adding function. Then that could be used instead of chr_playback_block. It would not only simulate "AI Hypos" but better AI and player regeneration than chr_set_health. Smooth health increment (for player) can be done in a looped BSL function. 20:35, 17 March 2009 (UTC)

:Done that already, in ReOni. The problem lies in the fact that there isn't an easy way AFAIK to copy a function using the Daodan. The other problem is that Macs would be left out cold. [[User:Gumby|Gumby]] 08:24, 18 March 2009 (UTC)

::Hm, do I actually even need to say anything? The conversation is going well without me ^_^ I find your idea interesting, Loser, but I personally just can't focus on it at this point, or I won't be able to help Gumby with the Edition (Real Life is knocking hard on my door right now and demanding me to cut down on my Oni time). Besides, any topic beyond BSL is kinda over my head anyway :-) --[[User:Iritscen|Iritscen]] 14:35, 18 March 2009 (UTC)

:::Ran into a small problem, the character still rotates, even with "fromhere". :( [[User:Gumby|Gumby]] 19:07, 18 March 2009 (UTC)

==Pre-beta image==
Hello,

This pre-beta image really seems bio lab to me. Didn't you agree?

[[Image:Pre-beta Vago Lab.png]]

See you. [[User:Script 10k|Script 10k]]

:Ah, you're right, that must be the pre-beta night-time version of the Lab! I've re-named it and moved it to the proper place on the page. Thanks. --[[User:Iritscen|Iritscen]] 01:31, 23 November 2009 (UTC)

==Newbies==
Oi who are all those never editing newbees? Are you sure they are human? --[[User:Paradox-01|Paradox-01]]

==About operators==
You said '=' is an alternate form of 'eq'. Are you sure? I was considering '=' to be used for definition and 'eq' for comparison.
[[User:Lukas Kreator|Lukas Kreator]] ([[User talk:Lukas Kreator|talk]]) 16:34, 11 November 2012 (CET)
:My bad, you're correct. '=' is the assignment operator. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 19:49, 11 November 2012 (CET)

==slowmo==
"no idea why I wrote that about slowmo"

EdT told me when making the Old China level that it was different in mac and pc. If you check the scripts you will notice that the parameter values are different for each version. Not sure how it works on mac since I don't own one. [[User:Script 10k|Script 10k]] ([[User talk:Script 10k|talk]]) 17:32, 28 April 2013 (CEST)

:Yes, I see now, that was why I wrote that. I guess I have to ask EdT about that. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 17:37, 28 April 2013 (CEST)

::The answer, I don't know. I believe that normally, slowmo works the same for both PC and Mac. However, in the old China Mod, there was a big difference. For the PC slowmo(100) lasted less than 2 seconds, on the Mac is was more like 15-20 seconds and during that time you couldn't do anything. So we changed it to slowmo(30) for the Mac, but it could simply have been my computer not able to handle all the action of the final battle. :) [[User:EdT|EdT]] ([[User talk:EdT|talk]]) 00:36, 8 May 2013 (CEST)

:::Hmm, okay. Well, I guess we'll just have to keep an eye out for a possible difference in the future (maybe it's really just tied to computer performance, as you indicated), but it probably won't crop up often since slowmo isn't used much. Thanks for the response. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 00:43, 8 May 2013 (CEST)

==Trigger volumes==
As the community achieved a lot in the past years, I wonder if it's now possible to show the trigger volumes in Oni. Is it? [[User:Ssg|Ssg]] ([[User talk:Ssg|talk]]) 23:32, 27 March 2014 (CET)
:Yes; in fact it's funny you should ask, because this ability was just added in Windows by the [[Daodan DLL]] within the last couple weeks: http://web.archive.org/web/20160224192402/http://oni.bungie.org/forum/viewtopic.php?pid=48117#p48117. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 23:39, 27 March 2014 (CET)
::Wow, that's what I call 'right on time'. Thanks for the link. [[User:Ssg|Ssg]] ([[User talk:Ssg|talk]]) 00:02, 28 March 2014 (CET)

[[Category:Userspace]]

File:TXMPCALIG.jpg

2025-12-26T06:12:32Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

:[[wikt:%E6%9D%8E|李]] [[wikt:%E6%BA%B6|溶]] [[wikt:%E9%8E%AE|鎮]] - Li Rongzhen
:[[wikt:%E6%B2%88|沈]] [[wikt:%E7%9A%9A|皚]] [[wikt:%E7%80%9B|瀛]] - Shen Aiying
:[[wikt:%E6%9C%B1|朱]] [[wikt:%E4%BB%B2|仲]] [[wikt:%E8%8B%B1|英]] - Zhu Zhongying
:(Thanks to [http://web.archive.org/web/20160225052353/http://oni.bungie.org/forum/viewtopic.php?pid=9299#p9299 gmsly] we have a [https://www.spieleforum.de/t/uebersetzung.617155/page-5 source] now.)

[[Category:Logos, icons and symbols]][[Category:Textures]]

User:Geyser/STFUn00b

2025-12-26T06:12:24Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

On second thought, I'm backing up this discussion for future reference. That way, when another shitstorm threatens, we can save everyone a lot of trouble by linking to [[User:Geyser/STFUn00b#Moral_closure]] early on. This page can be used for backing up other topics than the one already covered, like wiki management or OBD knowledge for example. Whatever you do, however, be sure to provide a suitable - concise and explicit - moral closure to the topic: try to put the problem in a nutshell, so that discussions referencing this page can go straight to the point.
::[[User:Geyser|geyser]] 03:37, 28 August 2008 (CEST)
==Flag browsers etc==
===BSL talk===
Maybe I'm just stupid, but I downloaded the version of OniMenu from your site, under the Tools folder in the OTA folder. I need to find flags to use for some scripting I need to do to record some video. Urg. Anyway, I successfully used a past version (also labeled 3.0, strangely, but with fewer .bsl files), and I thought that I could put the OniMenu scripts in the global folder, add "func pre" to the main function for each level, and do the reverse-flipping kick and the menu would come up. Has something changed? Also, I may be blind, but I searched the forum and didn't see any recent threads devoted to explaining how to use it, and this wiki has no documentation for OM either.

What's happening when I insert "func pre" is that the level fails to load past the point of that code. I also tried putting the OM scripts right in the "compound" folder (the level I want to browse) but no luck. No enemies, nothing goin' on. I'm probably making a simple mistake but I'm out of ideas. --[[User:Iritscen|Iritscen]] 02:39, 24 August 2008 (CEST)

:What I do is run Oni in window mode, then look at the flags listed on the pages found here: http://zdlo.oni2.net/Items/Flags/ and then use chr_teleport 0 flag# to find locations I could use. [[User:EdT|EdT]] 03:54, 24 August 2008 (CEST)

::Okay, I guess I'll take that approach, although I'd like to find out at some point what I did wrong with OM. Thanks, Ed. --[[User:Iritscen|Iritscen]] 04:46, 24 August 2008 (CEST)
:Apart from the global folder not working on the Mac, there should be no problem. If in doubt, provide a snapshot of your IGMD folder. Also consider using the PC version, for which you can use [http://zdlo.oni2.net/Scripts/DeveloperMode/FlagMap/ THIS]. More generally, I'm looking forward to some follow-up to '''Talk:Running_PC_versions_of_Oni_on_the_Mac''', and I'm curious why you're not using the PC version for recording. --[[User:Geyser|geyser]] 11:40, 24 August 2008 (CEST)
:Lately I've been browsing flags in a simplified manner, by repeatedly entering "my_flag= my_flag+1; chr_teleport(my_flag); chr_facetoflag(my_flag);" from the console and occasionally setting my_flag explicitly (when there are large gaps between flag IDs). Of course during this process I keep an eye on the lists found [http://zdlo.oni2.net/Items/Flags/ HERE] or [http://geyser.oni2.net/OBD/BINA/OBJC/FLAG/ HERE]. --[[User:Geyser|geyser]] 11:40, 24 August 2008 (CEST)
::Has anyone considered making an OniMenu-type script that actually lists a level's flags with descriptions of their locations in the level? You could drill down the menus, maybe starting with choosing what level's flags to look at if there's no way to find out the current level through BSL, then in a submenu choose the area of the level to go to, then choose the specific spot. In other words, scriptifying ZDLO's flag tables. It seems like a fair amount of work, but it would be easy work, mostly copying and pasting BSL code (wow, that guy in the Bungie West tour video was right, programming is cutting and pasting!; what was his name?).
::Re: running Windows Oni, I anticipated having to do that to capture some of the modding work sooner or later, but nothing so far has required doing so; the fact that certain mods, like OTA, are more functional on PC really doesn't matter when all I'm showing in the trailer is a few seconds of mayhem. However, you have pointed out that I completely flaked out and never made a response on the PC Oni on Mac page. My bad, I'll fix that in just a little bit. --[[User:Iritscen|Iritscen]] 16:35, 24 August 2008 (CEST)
:'''choosing what level's flags to look at if there's no way to find out the current level through BSL''' You're forgetting that the global folder doesn't work on the Mac, and so the menu you suggest would have to be level-folder-resident anyway. and even if it had a global component, flag-related information would just go in level-specific BSL files: the global core wouldn't "detect" the level, it would just load the currently relevant level-specific script (see [http://geyser.oni2.net/OniTeamArena/WIP/IGMD_OTA2.ZIP THIS] for an example). --[[User:Geyser|geyser]] 01:37, 25 August 2008 (CEST)
::I suppose your method would work fine. But I wasn't forgetting (this time) that the Mac couldn't do global scripts, I was actually imagining that one monster script would cover all 14 level files' flags, and that single script could get put in each level's folder so the user wouldn't have to worry about matching up a script to each level as part of some 15 folder-spanning network of BSL (plus it makes more work if there's a 1.1 release and they have to replace a 1.0 core script and then all the level-specific scripts (in case the 1.1 core doesn't support the 1.0 level scripts)). It's just more efficient that way. --[[User:Iritscen|Iritscen]] 04:42, 25 August 2008 (CEST)
::'''I was actually imagining that one monster script would cover all 14 level files' flags''' That would have a chance of overloading the BSL engine, which can only load this much logic at a time. I wouldn't know about the "efficiency" of a moster script, and I'm not sure what the file-buffer limits of BSL are, but it's typically more sound to provide only the logic relevant to the current level. As the designer of OTA, I know what I'm talking about ^_^ --[[User:Geyser|geyser]] 15:26, 25 August 2008 (CEST)
:'''In other words, scriptifying ZDLO's flag tables.''' SHORT ATTENTION SPAN ALERT! Didn't I link to [http://zdlo.oni2.net/Scripts/DeveloperMode/FlagMap/ THIS] above? It actually works on the Mac, except you're not able to read the healthboxes. You can easily make a version where you can review the IDs of the group of flags being shown and cycle through them. --[[User:Geyser|geyser]] 01:37, 25 August 2008 (CEST)
::MISSING MY POINT ALERT. I ''am'' now using ZDLO's tables in the way that Ed suggested, but it would be even cooler to meld his grouped, descriptive approach with your OniMenu system so it's all in-game and you can try each flag out by teleporting there. That's what I was saying. Right now OM makes you use an outside flag-number reference and you have to laboriously type in flag numbers by punching and kicking, so my idea is a landmark improvement for modders. That being said, how many people would be using such a script? So I'm not suggesting anyone jump on it. Just thinking out loud (I know you love it when I do that).
::P.S.: Healthboxes? What healthboxes? --[[User:Iritscen|Iritscen]] 04:30, 25 August 2008 (CEST)
:'''It seems like a fair amount of work, but it would be easy work, mostly copying and pasting BSL code.''' That'll be a "no comment" for me. Same for the words of wisdom about the essence of programming... --[[User:Geyser|geyser]] 01:37, 25 August 2008 (CEST)
::I think if anyone ever asks me, "Does geyser have a sense of humor?", I'll use the same response: "No comment." --[[User:Iritscen|Iritscen]] 04:30, 25 August 2008 (CEST)
::'''I ''am'' now using ZDLO's tables in the way that Ed suggested''' You're the one who missed my point. I've been telling you that ZDLO not only wrote up the tables mentioned by Ed, but also came up with a series of menu-like scripts (hosted [http://zdlo.oni2.net/Scripts/DeveloperMode/FlagMap/ HERE]). Those scripts have a new core tailored for the job, much lighter than OniMenu: a level's flags are displayed one group at a time, roughly following the groups established by ZDLO himself. By design, you don't even have to teleport anywhere, because all the information (every flag's location, facing and ID) is displayed by means of dummy characters: you just walk around and see the info. "Healthboxes? What healthboxes?" - precisely. The ID of the flags is displayed as the health of the dummy characters - this is enabled by ai2_showhealth=1 and takes the form of black text in a white box above every character's head (there is also a health bar extending upwards by 1 world unit for every hitpoint). The only problem is that on the Mac the health box above the characters isn't displayed, so you can not read a flag's ID directly. One workaround is to complement ZDLO's scripts with a mini-flag-browser that works within the currently displayed group of flags. A simpler solution is to list the IDs of the current group of flags, so that the user can explore them with chr_teleport. Finally, someone who ''can'' see the healthboxes can take a few screenshots and post them somewhere, as a complement to ZDLO's tables. Along with or instead of ZDLO's scripts, you can also use Neo's OniBrowser, which displays stuff like FLAG or TRGV right in the 3D view of a level. --[[User:Geyser|geyser]] 15:26, 25 August 2008 (CEST)
::'''how many people would be using such a script?''' The main point here is that developing such GUI-like tools (the term you use is "landmark improvement for modders") amounts to empowering lamers. A fluent modder typically won't limit himself to the range of flags (or other OBJC) available in the original levels. And if that modder ''does'' want to review some original flags, then the available lists, tables and browsers allow him to do so efficiently enough. In that sense, ZDLO's set of flag viewers are a gadget that may seem nifty to the lazy and clueless, but are definitely not a revolution for those who can actually use the knowledge to create great mods - those people know better than to ask or wait for point-and-click nicicles. If anything, they've been using OniBrowser to review that kind of stuff for the past few months... --[[User:Geyser|geyser]] 15:26, 25 August 2008 (CEST)

----
===Shitstorm===
:::Okay, I was totally ignorant of ZDLO's flag browser, so thank you for explaining it. I also didn't realize that PCs could display text above character's heads, but it sure explains [[:Image:Run Loser.jpg|this]].
:::Also, you might be interested to know that I figured out why we disagree on the basic idea of making user-friendly modding tools; it came to me in a flash of insight. [https://www.apple.com/getamac/ads/ ''I'm a Mac and you're a PC'']. The guiding principle behind the Macintosh was that if you provided a well-designed GUI, creative people could be more creative. It would empower them. For years, even after Windows was released, there were DOS stalwarts who insisted that it was better to have to do the hard work from the command line than to have 'frivolous' things like mice and windows. Even though no one still adheres to the command-line-is-better school of thought, that way of thinking has a hold on many of the technically-smart Windows users to this day. Once a person switches to Mac, they realize that making basic UI tasks intuitive, and making multimedia work easier encourages the user to actually ''be'' creative. There's no need to pull oneself over a technical hurdle like, say, using OniSplit from the command line (and oddly enough, you seem to support the idea of a GUI for OniSplit) in order to get things done so it's easier to let your initial enthusiasm carry over instead of getting mired in stuff that should be behind the scenes. A recent exchange from the forum (names have been changed to protect the innocent):
<blockquote>
:::OniVirgin: I think I should add some new moves to Yosemite Sam because he doesn't have as many moves as other characters.
:::Burt: OniVirgin: You might be interested in this page: <nowiki>http://wiki.oni2.net/OBD_talk:TRAM</nowiki>.
:::OniVirgin: That page looks useful. But... my new semester is coming and I must focus on my study. Maybe other time I can modify it...</blockquote>
::::::What happened here? Our new and enthusiastic modder is thrown off by having to absorb 10 screenfuls of technical stuff that's not in his native language (and really, who ''does'' speak hex fluently? ;-). Now, imagine if we had a visual 3D TRAM editor, or even a GUI for OniSplit that basically said, "What parts of the TRAM do you want to focus on?" and there was a pulldown menu for "knockback", "damage-dealing bones", etc. and it would highlight those in the actual Oni binary data for an animation, and they could type a new decimal value in for damage, or pick a new bone from a popup menu, and the GUI would convert it to hex. That's just a random example of the philosophy of "enabling creativity through user-friendliness", and it's essential to the mindset of anyone who loves Macs. --[[User:Iritscen|Iritscen]] 17:31, 25 August 2008 (CEST)
:::::::Iritscen, love_Oni is not a fool: http://web.archive.org/web/20160225132841/http://oni.bungie.org/forum/viewtopic.php?pid=9103#p9103. He may not be the best modder out there (like anyone is just starting out), but he is not an "OniVirgin" who is put off by a hex editor. At one point or another most of the modding community is "Busy" for one reason or another with real life.
:::::::#Do you know how much of a pain in the arse it is to create a good GUI?
:::::::#Is it really worth it to spend the time required to make such a GUI? There aren't even a dozen modders at this point, and most of them are at the point where they don't need a GUI (Unless you count OUP as a GUI, but it is really only a glorified hex editor). Would the time spent on creating a superb GUI be more than the time that it would save for the people who use the GUI?
:::::::#Running Onisplit is not a "technical hurdle". "Onisplit.exe -import:nosep *copy* *paste* *copy* *paste*". There, I'm done. If I need to do the same action again, I can just hit the up arrow. In the end, I think hex editing through OUP and doing things the "hard way" actually enables more creativity. You learn exactly how things work out. If I need to make a small change, it takes me about 20 seconds to open up OUP and do it. If I need to make a large change, I can export the file to .xml through Onisplit and do changes there. For many things, the level recombining (level0) is the longest part. A GUI would not speed that up!!
:::::::#Back on topic: What kind of GUI would you create for a simple flag browser anyways?! What we have seems about as good as it is going to get. (And you can run the Windows version through Bootcamp anyways. Why aren't you?) [[User:Gumby|Gumby]] 18:55, 25 August 2008 (CEST)
:::::::::0. I never called love_Oni a fool, that was your choice of wording. I respect love_Oni's intelligence, but he is a "virgin" to many aspects of Oni modding (I am too in some areas, but this was a matter of providing a real-life example and it just so happened that I saw a post that fit my needs; was it necessary to point out to geyser, who doesn't browse the forum, who I was actually quoting?). Also, "Virgin" was a pun on his adoration for Madonna. I can assure you that he is not alone in being put off by having to dedicate to memory the material on the TRAM page. That's stuff that should be turned into an intuitive program so end-users don't need to know it.
:::::::::1. No, I don't. It doesn't seem that hard to me.
:::::::::2. I've already explained my views on this so I won't bother repeating anything, except to say that there might very well be more modders if we had a GUI. Why are you pissed at me when I already acknowledged that there weren't many modders who would use the tool? I was the one who said that first.
:::::::::3. Making changes via a command line and XML bloody well is a technical hurdle. Why was the GUI invented, otherwise? No disrespect meant to Neo, who I think is awesome. He's like the frontline hacker who publishes his discoveries, and then others start from where he leaves off to bring his hard work to the masses.
:::::::::3.5 "'''doing things the "hard way" actually enables more creativity'''" Crap, did I call this one, or what, geyser? Some people are impervious to progress, it seems.
:::::::::4. Huh? I already outlined what I would do for a flag browser, then I found out that ZDLO has already done it. End of story.
::::::::::Sorry, spoke too soon. ZDLO just cut-and-pasted (there it is again!) the code geyser wrote for entering flag numbers. My answer to your question, then, Gumby, as to how I'd design the flag browser was still already answered up top. Let me... cut and paste it! '''an OniMenu-type script that actually lists a level's flags with descriptions of their locations in the level? You could drill down the menus, maybe starting with choosing what level's flags to look at if there's no way to find out the current level through BSL, then in a submenu choose the area of the level to go to, then choose the specific spot. In other words, scriptifying ZDLO's flag tables.'''
:::::::::4.5. '''"Why aren't you?"''' But, I am.
:::::::::P.S.: Mac users are in an inferior modding situation because we can't use every program (OUP, OniBrowser e.g.) that you can. That doesn't mean that Mac users should be expected to do all their Oni work in Windows. But ultimately, why are we having this conversation? Gumby, any GUI that someone wrote for Windows would have to be written by someone else for the Mac, right? So this discussion does not entail any work on your part. Really, at this point, it would fall to Ed (who is already doing related work) and myself to do something nice for Mac users. And perhaps that's just as well, if we're the only ones who appreciate GUIs. I can guarantee that the other Mac users would lap our work up eagerly and modding on our side would outpace the Windows side. For the time being, of course, I can only talk about it because I won't have the time to act until a couple other Oni projects are done. --[[User:Iritscen|Iritscen]] 22:13, 25 August 2008 (CEST)
::::::::::0. Define end-user? Modder=/=End User. End user is the guy who installs the mod. If you are making a mod, you should know what you are doing. Modding isn't for the lazy.
::::::::::1. Then don't complain about not having one. Make it yourself.
::::::::::2. Because it is easier to fine tune things with hex and a command line program. "You can't do everything in point and click apps".
::::::::::3. Making a GUI for editing every single part of Oni is also a technical hurdle. :)
::::::::::3.5 See point 2. Unless the same guy who makes the underlying program makes the GUI (not true here), the GUI's features will not mirror the program's features. And at some point, the program will have more features than will properly fit on a GUI. See point 1. This will either lead to a messy\unfriendly GUI (bad), or a GUI with features removed (also bad). [[User:Gumby|Gumby]] 22:45, 25 August 2008 (CEST)
:::::::::::0. The modder is the end-user of the mod-making process, just not the mod-''using'' process. And modding ''should'' be available for the lazy. I demand a retraction of your statement :-) Seriously, though, just because someone wants to "mod", that term could mean anything from changing one parameter of one TRAM, to making a whole new scenario. So is it worth it to learn all these technicalities when you just want to mod small-time stuff? Arguably not, with the way things are right now. But here's the point I want you to remember: I agree with the stetement "If you are making a mod, you should know what you are doing." But only if you define "what you are doing" as "how to make quality modifications to the game", not your apparent definition of "what the changes you make are doing at the hex level". My definition focuses on the creative skill of the modder, yours focuses on the ability of the modder to learn nerdy geek stuff; I still maintain that those are almost opposite skills. Once again, this is the whole point of the GUI; to not know what you are doing at the lower level of the OS as long as it produces reliable results at the upper level. Many OS X users couldn't care less about the Unix layer of the OS, and the beautiful thing is, they don't have to.
:::::::::::1. Well, maybe I will *sticks out lower lip poutily*. But as I indicated, that's gotta come after the trailer and the HD models. I think that if I find a compelling way to present a total Oni-modding package as a GUI, you'll come around to my way of thinking soon enough and want a Windows version :-)
:::::::::::2. If I knew what you meant by "fine tune", I would respond to this, but I don't, so I won't. :-p But whatever you mean, I probably don't agree. :-P x 2
:::::::::::3. Yes, quite true. But it's only a hurdle for one or two people who have to make the tool, as opposed to every single person who comes along wanting to mod that has to learn hex and endians. If you question the act of programming an interface because it's "hard", you call into question millions of dollars of software that's sold every year and decades of common practice. I'm sure that's not what you intend to say.
:::::::::::P.S.: I genuinely want to apologize for spamming geyser's page with this stuff; it all started with an innocent question about OniMenu and just snowballed from there. The basic problem I have is that I keep thinking for some dumb reason that if I suggest something, others might actually agree with me and do the work I described. Instead it looks like I can only see something done that I think should be done if I do it myself. Talking about it beforehand only makes unnecessary arguments. I'm starting to see that now. --[[User:Iritscen|Iritscen]] 23:32, 25 August 2008 (CEST)
::::::::::::Ok, I am quickly tiring of this argument, it isn't going anywhere.
::::::::::::Might I add that this is not the software industry where millions of dollars are made every year? This is a roughly open modding project, where nobody gets paid. If anything, the project on the whole loses money due to webspace costs (thank Alloc for keeping oni2 up) and time that could be spent doing other things. :) [[User:Gumby|Gumby]] 00:21, 26 August 2008 (CEST)

----
===Moral closure===
:PLEASE READ THIS CAREFULLY
:Thanks everybody, and special thanks to Iritscen who started this, er, whatever it is: for the sake of the argument, let's not call it a flame war. Overlooking the existing flag-browsing tools was forgivable, but the generalization that followed annoyed me deeply, all the more as it gravitated to the infamous "wouldn't it be cool if modding was at every fanboy's fingertips" topic, with brief excursions into PC-VS-Mac territory. I hated every bit of it (including my own comment on the matter), and I will be deleting this whole section in a short while.

:If I wanted to participate in the debate or give it some sort of moral closure, I could say things like:
::"Oni's models, levels and animations were done in 3D Studio Max and AutoCAD, and Windows at that time was nowhere close to today's OS environments - OS X or Vista or Ubuntu or whatever - in terms of point-and-clickety-friendliness..."
:or:
::"Speaking of AutoCAD - a highly professional tool if there ever was one - did you know it is mostly operated through a command-line interface? Another contemporary 3D application that features a command-line is Softimage|XSI - used among others by the creators of Half-Life 2... and by certain fluent Oni modders."
:or:
::"Creative people are creative no matter what the OS or GUIs at their disposal, and have always been. If this is not the case today, then our potential creators have been swallowed by the point-and-click generation, and we're pretty much screwed."
:or:
::"If a modder's idea of upper-level modding is messing around with Oni's animation system one parameter at a time, that modder probably sucks really bad. Hordes of such people picking at Oni by means of an ideal GUI is not a pleasant perspective. Or is it?"
:or, making things slightly more personal:
::"If you think you're the one who'll bring that ideal GUI to the community - note that this typically requires low-level thinking rather than point-and-click enthusiasm - by all means don't talk of it "beforehand" - that little word actually doesn't make any sense in the absence of subsequent delivery. We'll see about awesome in due time, but why doncha produce something that doesn't suck, first?"
:and:
::"If you're in fact trying to hype ''other'' people into designing the ideal GUI, I assure you that those other people all understand the amount of programming work and raw binary knowledge that was put into OniTools and OniSplit/OniBrowser, and they also understand the appeal and potential of future developments of Oni modding (no thanks to you). Thus, making levels and animations conveniently moddable are Neo's top priorities on planet Oni ATM, thanks for asking."

:But since all I want is get this over with, I'll just say these few things to Iritscen:
:You are making a reasonably good point in your diatribes, which is that complex entities such as animations and geometry should be authored in a GUI environment rather than in raw hex. OK... That kind of trivial statement is damn hard to disagree with: likewise, it doesn't take a Male Scientist to know that I, geyser, wouldn't spit in the face of the one who'd hand me the equivalent of Bungie West's authoring pipeline on a silver platter; a set of modding tools reasonably close to what Oni's developers were using can't be bad, now can it?
:Why aren't we agreeing with you, then? Sure your point is trivial, but we could at least give you a half-hearted "Yeah, you're right... I guess" - and we probably ''would''... But then you go and bury your one trivial point in a landslide of rhetorics, sarcasm and verbal onanism, and to make things worse you consistently shove the obvious in our faces as if it was an all-new initiative of yours. That's typically the situation where I'm no longer in a position to agree, and all I feel like saying is STFUn00b.
:Probably that "initiative hi-jacking" I mentioned is just part of your hey-mom-look-I'm-a-developer act, and I can try and turn a blind eye on it; after all, I used to be like that too. However, what I can hardly understand or tolerate is that you never drop your high-level end-user philosophy even when you're talking about programming. To focus on the GUI is OK for a salesman or consultant or beta tester, but if you're serious about that developer hat of yours, you have to get down to earth from time to time. Development is work. Modding is not for the lazy/clueless, and programming even less so. A GUI for Oni modding is everything but abstract, so you can forget all the guru talk you've picked up in computer science shool or wherever: you're interfacing with real-world data structures; you're doing 3D graphics; you're generating content for engines and tools that you didn't code yourself: you need to think on the low level and to pay elementary attention to every single thing you see or do. So it's OK to be a point-and-click enthusiast, but I assure you: you have to drop that enthusiasm a bit and pick up something else before you can actually sit down and code the point-and-clickety GUI you're dreaming of right now.
:P.S. "ZDLO just cut-and-pasted (there it is again!) the code geyser wrote for entering flag numbers." You couldn't be more wrong here, so I think you didn't actually read or test ZDLO's scripts at all. These assumptions of yours are yet another thing that can get an actual programmer ''very'' cross, as in STFUn00b again. ZDLO used his own code for the most part, and no, BSL is definitely not about cut-and-pasting. You need flawless attention and awareness, and you better get used to thinking of programming that way.
:P.P.S. "geyser, have you ever thought about making the change to an uppercase G? You should totally go for it!" Just because you have nothing to say doesn't mean you should tell me how I should capitalize my nickname. I chose it to be lowercase for several reasons, one of which is a permanent note to self about humility; that one never gets old. Also note that in many circumstances capitalization wins, e.g. here on the wiki (user names are capitalized everywhere except in signatures) or on YouTube. So, STFU forever.
:P.P.P.S. This is unrelated to the above, but I have come to a point where I absolutely have to break virtually all contact with Oni, or else I'll never pick up the pieces of my PhD. I'll post an update when I delete this section, but basically that means: read-only access to the wiki at the most, maybe some updates in the form of links to freshly uploaded stuff, and definitely no chat.
::[[User:Geyser|geyser]] 17:54, 26 August 2008 (CEST)
:::Well, I'll miss our lovely chats, geyser *rolling eyes* Obviously I won't spend the time to rebut any of the above accusations since it's going to be erased soon (and I won't miss it). I will just say, re "initiative hijacking", that I am not guilty of that per se, only suggesting something and then finding out someone was already doing it. And you're really daring me to go to town on that Oni modding tool, aren't you? I'm not saying I will, but we'll see what happens when I get to a stage where it's possible. I'd also love to write a manifesto about how programmers usually epically fail at interface design and how they need to think more about the end-user to move the profession forward, but that is really something that, as you point out, I need to demonstrate through action or else shut up about.
:::P.S.: If you can't tell that my edit summary ("you should totally go for it!") was a blatant and silly trap to provoke your annoyance, which you fell squarely into, then you have my condolences :p
:::P.P.S.: I appreciated your speech on humility that ended with "STFU forever", clearly your plan to stay humble is working. By the way, I'd like to announce that I am changing my name to <big>IRITSCEN</big>.
:::P.P.P.S: I didn't plan these addendums to match yours in number, but I bet that, even being a coincidence, you find it somehow annoying. I'd just like to say that I hope your whole doctorate thing goes well, if that is indeed the stage you're at. I can hardly say that we're best friends... or even moderate friends... but I think I can call you my worst friend. So I wish you well in your endeavors while you're away. --[[User:Iritscen|Iritscen]] 22:44, 26 August 2008 (CEST)
::::It's provoking people gratuitously that's sad, not pointing the finger at gratuitous provocations. IMHO.
::::I didn't ask for any rebuttals. I just asked you to read all of the above carefully, and I hope you have.
::::"only suggesting something and then finding out" - in ''our'' case, that's often an attention span issue.
::::"I'd also love to write a manifesto about..." - right, as if ''that'' hasn't been done before, a dozen times.
::::"we'll see what happens when I get to a stage where it's possible" I wouldn't have put it better. Bravo.
::::I wish myself the best of luck, too. As for you, remember to exercise restraint. Think before you act.
:::::[[User:Geyser|geyser]] 03:37, 28 August 2008 (CEST)

==Cherry picking==
::
:P.S: ... and what about replacing "serendipity" with "cherry picking"? I think it would be more intuitive. [User:Guido|Guido]] 10:00, 26 October 2008 (CEST)
::Well, the meaning of "[[wikipedia:Cherry_picking|cherry picking]]" was ''really'' not intuitive to ''me'', so I had to look it up. And it's still not clear to me what exactly it means as applied to this wiki (biased sample? WTF?) or why it's more appropriate than "[[wikipedia:Serendipity|serendipity]]". Eventually I meant to replace this with a link to the [[OniGalore_talk:General_disclaimer]], which would be a sort of condensed site map. --[[User:Geyser|geyser]] 11:10, 26 October 2008 (CET)
:::It's true that I don't think "cherry picking" is the right phrase to replace "serendipity", but the more important question is what "serendipity" is supposed to mean in the first place. You should be aware that, as fond as you are of "serendipity", geyser, I can confidently say that a lot of native English speakers do not know its meaning, and those who do, like myself, are still at a loss as to what it means when used here. When I first saw that the word was a link, I assumed it would link to [[Special:Random]], not a dictionary definition of the word that still gives it no context....
:::"'''a link to the [[OniGalore_talk:General_disclaimer]]'''" o.O ...Come again, geyser? --[[User:Iritscen|Iritscen]] 17:57, 26 October 2008 (CET)
:Clicking "Random page" has less to do with serendipity than following intrawiki links. The idea is that beyond a certain amount of cross-linking, the wiki virtually "navigates itself", and allows casual/curious readers to end up in unexpected places, through a set of more or less loose associations with what they were initially interested in. Maybe I'm the only one who reads wikis like this (starting with Wikipedia) and enjoys it... Anyway, "serendipity" in the context of our wiki (casual navigation powered by intralinks) is not meant to be self-explanatory right now. The actual thing that's supposed to be featured on the main page is the disclaimer: I used to link to it without the serendipity label, and I will re:link to it eventually, probably without calling it serendipity either. Thus thee serendipity thing is just a placeholder, or at least you can think of it that way. Of course, you can decide to kill that initiative (and delete the disclaimer while you're at it), but I wouldn't do that, or if I did, I'd expect unexpected retribution. My advice is to ignore everything you can ignore, and I'll do my best to ignore bureau-cats and other uncyclopedic spam that is only funny to certain people while on certain drugs --[[User:Geyser|geyser]] 22:04, 26 October 2008 (CET)
::<sigh>Because the Disclaimers page is ''so'' much funnier to ''such'' a larger audience :rolleyes:. The fact that you use the words "uncyclopedic spam" simply blows my mind when you were just talking about [[OniGalore:General disclaimer|this]] page in the same breath. Anyway, what I was trying to ask above was, How is the Disclaimers page in any way connected with your concept of browsing the wiki by serendipity? And don't get jumpy, I never said I was thinking of killing any initiative, I don't attack what I can't even begin to understand :-3. --[[User:Iritscen|Iritscen]] 01:39, 27 October 2008 (CET)
:::Quite simply, a list of ill side effects is a nice place to start browsing; every ill side effect linking to an article, ideally. Seen that way, the disclaimer has the potential of becoming a condensed site map (and I already told you that). Not in the present form, of course (remember that I was young and stupid when I stole SOW's disclaimer, so comparing your own silliness with it is not to your advantage), but as outlined in the footer and on the talk page (which I also linked to, for Mukade's sake). My own brainstorming and Gumby's should give you an idea of what's cooking. Just don't tell me we have to explain the meaning of every single item, because we all have better things to do right now. --[[User:Geyser|geyser]] 02:16, 27 October 2008 (CET)
::::Okay, now I get it, at least as much as I'm going to get it, I suppose. But if you think this plan was in any way clear before your last post, hate to tell ya, but it wasn't; don't act like you explained anything on the Disclaimers talk page, it's an incomprehensible list of gibberish right now. Whatever, have fun with it.
::::P.S.: By injecting humor into official wiki pages such as [[OniGalore:Policy|Policy]], I am *trying* to preserve fun while adding functionality, sorry if you don't see it that way, but I daresay most people will; heck, even Wikipedia has [[wikipedia:WP:BEANS|joke pages]] as part of their system of policy articles. --[[User:Iritscen|Iritscen]] 02:28, 27 October 2008 (CET)
:::::The functionality added by those official pages is nil, and the humor is IMO fairly tasteless, so in a way it's "worse than nothing". You know as well as I do that there's more than enough places on the web that cultivate that kind of humor; no need to develop it here as if our wiki was Yet Another Weak Hu--[[User:Iritscen|Iritscen]] 04:27, 27 October 2008 (CET)mor Site. If you can relate your humor to Bungie or Oni, that will already be more creative, if not better (I mean, since Bungie humor is already not very tasteful, either make the weak s##t part of the Bungie strain or leave it out). That's just my opinion of course, you're a big boy and I wouldn't want to tell you how to run an Oni wiki. ''<-- NOT ASKING FOR A FORMAL POLICY, OF COURSE; JUST TRYING TO APPEAL TO COMMON SENSE: THE WIKI IS NEITHER A SELF-INDULGENT BLOG NOR A PORTAL TO UNCYCLOPEDIA; SO LET'S AT LEAST TRY TO KEEP THE CRAP OUT
:::::"don't act like you explained anything on the Disclaimers talk page, it's an incomprehensible list of gibberish right now" Let's not play dumb and dumber, please. Care to go and read it again? Here's what it says at the bottom: ''<-- OOPS! MISTAKING THE DISCLAIMER FOR THE TALK PAGE WAS A VERY BAD IDEA''
::::::''The above masterpiece was outrageousy stolen (by me, [[User:Geyser|geyser]]) from [https://www.swo.com/ Science of War and Oppression]. '''I am looking forward to making [[OniGalore talk:General disclaimer|a more Oni-oriented variant]] (you're welcome if you want to help)''', but for now it's [https://www.swo.com/disclaimer.shtml SWO's original version], with a few original entries by myself. No, I don't have permission to redistribute their disclaimer. I'll try to keep it clean :)''
:::::You have had the ample opportunity to check out SWO's original disclaimer (incomprehensible list of gibberish? ''riiiiiiight'' ''<-- OOPS! SAME MISTAKE AS ABOVE, LOOKING AT THE WRONG PAGE''), as well as the talk related to ours, and the recent contributions by Gumby and myself have made the initiative all the more explicit. Sorry if you didn't get the picture, but I didn't want to insult your intelligence. ''<-- THAT ONE STILL HOLDS, I GUESS. I MEAN, GUMBY GOT THE IDEA ALL BY HIMSELF AND EVEN ADDED THE FIRST HYPERLINK...''
::::::[[User:Geyser|geyser]] 03:27, 27 October 2008 (CET)
:::::::Non-Oni-related humor... is that what's been burning your biscuits all this time about my jokes? Sorry, I didn't think we had a Bungie-only humor rule here. Let's try not to be so insular and snobbish, 'kay? Let's also try not to be insulting, although it's too late for that today -- having an Editing Policy page, a Copyrights page, or any page defining user rights and roles is a ''hell'' of a lot more useful than your original Disclaimers page. And I certainly read that note at the bottom a while back... how on Earth do you think that wording conveys your plans to make a Site Map out of random Oni phrases on a ''Disclaimer'' page? The longer you continue this back-and-forth, the more ridiculous you look. --[[User:Iritscen|Iritscen]] 03:35, 27 October 2008 (CET)
:::::::P.S.: In response to your point about not making the wiki a portal to other crap, I don't plan on doing regularly what I did with the Editing Policy page. But to clarify what I meant above in case you missed it, I don't think we need to be insular as a community, where anything that's not Oni or generally Bungie-related is automatically "crap". I specifically put a note in my Talk page about how a community can go too far in that direction and become a barricaded fortress of in-jokes that only the community elite actually understand. I prefer a more approachable take on humor, personally. But I will try to keep the external links to a bare minimum. --[[User:Iritscen|Iritscen]] 04:27, 27 October 2008 (CET)
:::::::stop bitching or my ninjas will come and find you! [[User:guido|guido]] 18:47, 27 October 2008 (CET)

[[Category:Userspace]]

User:Gumby

2025-12-26T06:12:07Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{|style="float:right" border=1 cellspacing=0
|[[Image:Flatline logo WIP.png]]
|}

Retired Modder

Has worked on:

*[[Daodan DLL|C-Daodan]]
*[http://oni.bungie.org/forum/viewtopic.php?id=702 Barrel].
*AE - History of Projects, in no particular order:
**[[AE:Glass#Deadly_glass]]
**[http://gumby.oni2.net/AE/BSL/cutscene/ Cutscene skipping]
**[[AE_talk:New_weapons#w18_asr2_Assault_Rifle]]
**[[AE_talk:New_weapons#w23_rla_Rocket_Launcher]]
**[[Flatline]]
**[[AE:Barabas#Regeneration]]
**[http://mods.oni2.net/node/62 Konoko vs. World]
**[[AE:OTA]] (minor upkeep+Arena of Pain)
*[http://web.archive.org/web/20160226095407/http://oni.bungie.org/forum/viewtopic.php?pid=10487#p10487 Onisplit shell extensions]
*Other stuff that is forgotten

[[Category:Userspace]]

History of Oni modding

2025-12-26T06:11:59Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{Hatnote|This article is a historical perspective on Oni [[wp:Video game modding|modding]]; for an introduction to how to actually mod Oni, see [[Introduction to modding|here]]. To download mods, you can start [[AE|here]].}}
As has been documented on the page about [[Oni]]'s overall development, time ran out for Bungie West to do everything they wanted with this very ambitious game. Just as some features had to be omitted, the promise of modding support<ref>In [[Harry]]'s [http://oni.bungie.org/special/part1/brent.html interview], Brent Pease, the Project Lead, said: "What we will do is, I'm about 90 percent sure of this, is give away the file format." He also promises with equal certainty that the tools for converting 3D Studio Max models into Oni models will be given away. Pease eventually left the project before its completion. Hardy LeBel, his replacement, would later say, "[Due to the time crunch] our primary focus had to be on completing the content and features of the game rather than building in support for the mod community." Additionally, Bungie no longer owned the game by the time it shipped, so it would have been legally questionable to release header files from the source code, which would be the simplest and quickest way to "give away the file format".</ref> also failed to come true. However, even before Oni fans realized that there would never be official modding tools from Bungie, they were already eagerly diving into the game data to see how they could mod it.<ref>Fans wasted no time in dumping the readable text from the executable and trying to figure out how to enable Developer Mode, starting before Oni's official release date by analyzing the demo. Little did they know it would take another five years before this particular goal would be reached.</ref> Nevertheless, the lack of any documentation or tools for modding undeniably slowed the development of mods within the community. Only since 2010 has the community's modding capabilities covered nearly all aspects of the game.

There are three basic areas in which the game can be modded: scripting, binary resources, and the engine itself. Along the way, we'll look at some key discoveries the community made in more detail.

==BSL scripting==
[[Image:One Tiny Mistake.jpg|thumb|225px|right|Konoko pulls her gun on the secretary in the beginning of Chapter 2, a change to the original cutscene made by a script which tightens up the story and provides a new challenge for veteran players.]]
Since the .bsl files were in plain text and in plain sight within the folders that held Oni's game data, it's not surprising that fans quickly learned some basic scripting commands by seeing what Bungie had written, and started making their own scripts. Further commands were discovered by dumping readable text from the engine, although not everything worked as it seemed it should.

As scripters were learning [[BSL]], they produced scripts that at first merely modified the original level logic in minor ways. Then they produced more original, often epic fight scripts; later, some ambitious modders scripted totally new objectives and mission layouts (e.g., Mariachi Bear's alternate storyline). Some of the most complex scripts are the [[OTA]] scripts which were eventually developed to make up for a lack of multiplayer gameplay.

However, fully original scripts are all the more prone to bugs. The first two are easier to set up, but extreme situations tend to overload the engine (as in "[[Blam!]]") in ways that scripters have trouble preventing. Testing the scripts required numerous reloads of the game. The process became much faster when the Developer Mode console was unlocked (see {{SectionLink||Finding Dev Mode}}) and individual commands could be tested easily.

While scripting is the easiest way to mod Oni, it's also the most limited, because scripts can only utilize the resources that the vanilla level has to offer.
{{clearall}}
==Binary resources==
===Private knowledge, public results===
[[Image:OniTools.jpg|thumb|225px|right|Ian Patterson's trailblazing Mac program OniTools was eagerly ported to Windows by other fans.]]
[[Image:OUP_txmpreplace.jpg|thumb|225px|right|OniUnPacker by Alloc, premiering in fall of 2005, provided a simple interface for finding the resource you wanted and displaying it, as well as replacing it.]]
[[Image:AE_Installer_1.jpg|thumb|225px|right|The AE mod installer released in 2009. For the first time, players could pick and choose what mods to install.]]
[[Image:AEI_main_window.jpg|thumb|225px|right|The AE Installer released in 2013 could update itself, the player's mods, and the patches made to the game. It was written from scratch in Java for ease of cross-platform support.]]
Fans with some expertise in parsing files with hex editors found that the level data files held four-letter codes indicating the start of each resource within that file. Before Oni even released, the community had its first resource modding tool, Ian Patterson's [[OniTools]]. While the author did not yet know how all the data worked, his program could at least parse it, and allow the modder to more easily edit each resource without having to count in hexadecimal. It also supported user-friendly replacement of texture maps, delta patches called CMPOs, and allowed inline viewing of the game's 3D models. There seems to be little evidence that this knowledge was put to use in modding the game resources beyond simple texture replacements, no doubt due to the lack of a complete understanding of how Oni's dozens of resource types were interrelated. But the open-source release of OniTools gave fans something to build on.

Independently, an intrepid programmer named Pierre Terdiman decided to import data from Oni into the game engine that he was writing from scratch. Called [[Konoko Payne]], it was a long-term project which took the form of (1) an underlying engine and (2) a short scenario for it that resembled a sequel to Oni. In order to extract models and animations from Oni and recreate them precisely in his project, Pierre became one of the early pioneers in reverse-engineering the game's resources, although his acquired knowledge remained largely private as the engine was closed-source.

===Hackers unite===
Perhaps the first place that knowledge of Oni's data was directly published online was on [http://oni.moltenstudios.com/tool/index.php Oni Master's site], which started as early as 2003 and was based on the source code for OniTools. Then, in 2005, [[User talk:Ssg|Ssg]] opened a site with a much more thorough examination of the game data (the site is now hosted at http://ssg.oni2.net). Later that year, this pool of knowledge was painstakingly moved by [[User:Geyser|geyser]] and Ssg to its final home on the newly-opened wiki OniGalore. The purpose of creating the [[OBD|Oni Binary Database]] was to allow collaboration, and soon [[User talk:Neo|Neo]] appeared on the scene, adding his own knowledge that he had been acquiring independently until then, and collaborating on further investigations into the resource formats. Today at least 95% of the binary resource formats are documented byte for byte thanks to their hard work.
:''Further reading:'' {{SectionLink|History of the Oni community|2005}}.

===Modding by candlelight===
Originally, modders had to alter these binary resources manually with hex editors to adapt them to their scripts. [[User:Loser|Loser]] was the first modder to manually edit the game data to go along with his scripting, creating a massively reshuffled Warehouse. Loser's [[AE:Warehouse|Warehouse mod]] included a global component (modified level0_Final), level-specific binary modifications, and a set of customized scripts that took full advantage of the modified binaries.

Minor binary modding had already occurred before Loser's Warehouse (thus, while compiling the [[OBD]] database, Ssg had released a version of level0_Final in which all of Konoko's combos were unlocked). Still, it was the Warehouse mod released in 2005 which first showed the "full" potential of binary modding. It inspired a short-lived initiative called the [[AE:BIP|Binary Improvement Project]] (BIP), aimed at providing upgraded binaries for all levels, not just level0_Final and level1_Final.

BIP was hindered by large upload/download sizes as well as by the potential legal issues involved in distributing entire files from the game; in 2006 it was replaced by a smarter alternative to supplying whole levels, in the form of [[OUP|OniUnPacker]]-based patches, and was termed [[AE:ONK|Oni ni Kanabô]] (ONK). The modder would edit his .dat/.raw files in OUP, and then release a single binary resource patch. This was both bandwidth-efficient and more legal-friendly, but suffered from one major limitation: the indexation and offsets of data vary a lot across the available versions of Oni. Thus, resources exported with OUP were not truly standalone or portable. Also, OUP still lacked the ability to import new resources alongside existing ones.

===Modular modding===
The advent of Neo's [[OniSplit]] in late 2007 marked a radical improvement to the community's modding methods. A command-line tool that runs on Windows and Macs, OniSplit breaks Oni's resources into standalone files, making mods truly portable across different retail versions of Oni. These resources can be exported to standard formats as text, images, sounds and 3D models, which after editing can be recombined into the level data files that Oni expects, and newly-made resources can also be packed into the level data. To take advantage of this revolution in modding, geyser began preparing an OniSplit-based port of some of the work done on BIP and ONK, which he hoped would be ready for the seventh anniversary of Oni's release in January 2008.

This "[[AE|Seventh Anniversary Edition]]" had major releases in January and July 2008. The tradition continued of using a central modding project to organize a general revision of Oni's content, as seen on pages like [[AE:Ninja]]. The project then changed hands to [[User:Gumby|Gumby]], who designed a framework and a GUI-based installer that allowed players to selectively install only the modifications that they wanted. This mostly moved the project away from a centralized improvement effort, though select mods were still bundled with the download. Since Oni's seventh anniversary had come and gone, the mod collection was renamed simply the "Anniversary Edition", aka the "Edition" or the "AE". Released in July 2009, the new AE's framework allowed modders to create their own "[[Making a mod package|mod packages]]". These could be stored on the {{OMD}}, then downloaded by the player and placed in a certain folder in order to see them in the Installer. Another release was made in May 2010 with more bundled mods and an improved framework.

Nothing new took place on this front until 2013, by which time the project had fallen into [[User:Iritscen|Iritscen's]] hands due to the retirement of geyser and Gumby. At this time, the release of the new AE included a brand-new Installer written by Alloc which could connect to the Mod Depot, offer all mod packages for download, and update the mods and patches already installed. The program [[XmlTools]] was developed by [[User:Script 10k|s10k]] to allow "patch modding" of resources in order to avoid conflicts when different mods attempted to modify the same resource. The AE's bundled content was stripped down to only minimal fixes for the first time, making all notable game modifications into optional third-party mods and ceasing any attempt at centralized game data improvement.

===New content===
Certain game resources were easy enough to reverse-engineer that the community was able to mod them almost from the time of Oni's release, such as textual resources and textures. Some game resources, however, were complex and involved multiple data types, such as character models, and, most obviously, levels themselves. These took a number of years to decipher.

OniSplit first gained the ability to import new character models in April 2008.<ref>See [[User talk:Neo/Archive2]].</ref> At first, since the focus was on the technical side of things, pre-existing models were used, either by modifying Oni's models, or by finding royalty-free models on web sites and converting them to Oni's 19-bone system. A more dramatic use of the character-importing ability came with the creation of a high-detail Konoko model from scratch in October 2010.<ref>[http://oni.bungie.org/forum/viewtopic.php?id=1727 OCF thread, "Konoko HD"].</ref>

A major obstacle with levels was the question of how to generate pathfinding (PF) grids for the AI. Level geometry could be imported fairly easily as of November 2008,<ref>See [[User talk:Neo/Archive5]].</ref> but AIs could not navigate the level. Manual PF grid creation was first demonstrated with the creation of the Arena level in November 2010.<ref>[http://oni.bungie.org/forum/viewtopic.php?id=1736 OCF thread, "Arena Level"].</ref> Automatic PF grid generation was introduced to OniSplit around June 2011. More comprehensive demonstrations of the community's level creation abilities came with [[User:EdT|EdT]]'s level "Muro's Lair" in August 2011<ref>[http://oni.bungie.org/forum/viewtopic.php?id=2024 OCF thread, "Muro's Lair - Preview"].</ref> and [[User:Samer|Samer]]'s level "Wilderness Preserve" in January 2014.<ref>[http://web.archive.org/web/20211202225410/http://oni.bungie.org/forum/viewtopic.php?id=2698 OCF thread, "NEW LEVEL : Chapter 17: Wilderness Preserve - Hasegawa Adventure"].</ref>

Work continues in all areas of modding Oni, as well as documenting the modding process.
{{clearall}}
==Engine patching==
===Finding Dev Mode===
[[Image:Sfeli Finds Dev Mode.jpg|thumb|225px|right|[[User talk:SFeLi|SFeLi]] documents his discovery in 2006: in examining the binary, he noticed that the list of cheat codes had a gap in it where one cheat had been deactivated – that code was for Developer Mode. For more history, see [[/The tale of Dev Mode|The tale of Dev Mode]].]]
Engine patching is needed when modders want to do things the game's scripts and data do not currently allow for, as well as to fix bugs. Bug fixes were the earliest notable achievement in engine patching, originally performed by a patching application that altered the Windows Oni executable directly, but a revolution in this type of modding occurred in 2006 when [[Developer Mode]] was finally discovered in retail Oni's code, and a means for unlocking it was needed.

The most foolproof method of altering the engine turned out to be replacing a library that Oni loads at runtime. Originally this was done by placing a library next to Oni.exe called vtuneapi.dll, which contained code written by SFeLi that would replace or patch functions in Oni. This library came to be known as the [[Daodan DLL]]. The code for it was ported from assembly language to C by RossyMiles. Eventually the decision was made to instead replace binkw32.dll (the library for playing Oni's intro and outro movies) because it loaded earlier in Oni's launch sequence. The DLL was later developed by Gumby and then Alloc, fixing more bugs (some of which result from modern computers running a {{Age|2001|1|29}}-year-old game), as well as adding new features. The DLL's features and settings are documented on the page for the DLL linked above.

Not long after the Daodan DLL was released for Windows Oni, it was discovered that the Mac versions of Oni still had Dev Mode in them, too. Instead of replacing the Bink Carbon Library that came with Mac Oni, the Omni Group port of the game application to Mac OS X was patched directly with a hex editor. In the fall of 2008, it was discovered that numerous BSL functions and variables that were thought to be removed from Oni for the Mac [[Mac beta 4|before release]] were still present in the code, and the ones which allowed Macs to run (almost) all scripts written for Windows Oni were "unlocked" by EdT using hex edits. Certain changes made by the Daodan DLL for the Windows version were also carried over to the Mac's [[OMNI|PPC game application]] in hex-edit form with Neo's assistance. Later, these changes were made in source for Feral Interactive's [[FERAL|Mac Intel port]].

===Bug fixes===
One of the most visible changes to the game that the Daodan DLL (and equivalent hex edits on the Mac side) made possible came about in July '07 when an error in Oni's AI routines was corrected by Neo, allowing the AI to dodge incoming fire more consistently. Fans had originally been disappointed to see the AI often run blindly into oncoming gunfire. With Neo's patch in place, previously glitched code now works as intended, allowing the AI to dodge projectiles by taking cover.

===Multiplayer===
The most ambitious use of engine patching has been to fill in for Oni's [[Multiplayer|missing multiplayer mode]]. In Windows this was done through the Daodan DLL by the [[Flatline]] project, which saw a rough alpha released in 2010. In Mac OS X, the [[Zukai]] project operated on a Mac equivalent of the Daodan DLL and released a rough alpha in 2015.

===New engine builds===
A new era in Oni's life began with the introduction in 2021 of [[OniX]], a rebuild of the game engine. It remains to be seen how far this development work will take Oni, but in theory the possibilities are almost endless.

----

==Footnotes==
<references/>

[[Category:Community history]]

AE:Trailer/Shapeshifting

2025-12-26T06:11:42Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

showing off all available character classes (since it's anecdotal you can also show Motoko and whoever), preferably in some nice place(s), with an orbiting camera

:Is this what you had in mind? http://iritscen.oni2.net/wiki/EdT-Shapeshifting.mov [Updated link. --Iritscen] --[[User:EdT|EdT]] 02:42, 9 August 2008 (CEST)

:It takes longer than I thought it would... We must take it down to 4 seconds or so by showing one ONCC for each ONCV: a red Fury with red hair, a blue one with a headband, etc. Another trick would be to show characters 3 by 3 (standing in a triangle, with their backs to the invisible player). Obviously, in both cases, you'd have to use scripts with chr_set_class (and in your case that means emulating the beta or the PC build). As yet another trick, random body sizes should be ruled out. Oh, and the location is rather dull, don't you think? There's not much for a scenery except for those (very) distant cars... That's a no-no. --[[User:Geyser|geyser]] 03:12, 12 August 2008 (CEST)

:Here's an alternative (5 seconds): (xvid compressed: 2 MB); (fraps raw: 56 MB)
:<strike>If you tell where to find the white BGI guys I can record a new vid.</strike> Found it. 
:Is the location okay? Or should I place them into the glass hall? --[[User:Paradox-01|Paradox-01]] 12:15, 12 August 2008 (CEST)
::Yes, Dox, that's already much better: consider yourself in charge of this "hasta la victoria" ^_^ As for the locations, the lab is nicer than most levels because of the warm sunset colors, but there's much more to the world than the lab. The glass hall would probably have looked better, but there are a few nicer places in {{C|7}}, {{C|11}}, etc; ideally, you'd avoid empty rectangular areas completely. Oh, and I don't know what's up with the white Spartans: who made them? they probably don't even have reflectivity? "my" BGI troops are black and that's it.
::As for the ONCC lineup, your "random" succession actually looks just as good as systematic switching would (3 Strikers, then 3 Furies, etc), if not better, and the random character size is not much of a problem in that case. Maybe ''mix up the ONCCs even more'', so that TCTF guys and "thugs" are not grouped together, but scattered among Strikers and Elites and Ninjas etc. I also recommend placing the 3 characters in a triangle and orbiting the empty space between them (just place the player below the ground, and use chr_nocollision and cm_height). If that's too much work (trigonometry...), you can use 4 characters arranged in a square.
::If you're courageous, you can also try the following, more in line with my previous suggestion. Set all the random body sizes to 1 (in the ONCC) and use 3 characters: one for females, another for Comguy-like skeletons, and another for the taller Striker-like characters. Then time the ONCC changes so that each of the 3 characters explores its range of ONCC in 4 seconds or so. The advantage of this is that you can actually play animations seamlessly on the characters (walking, taunting, whatever), and since their body size is continuous, it will ''really'' look like they're "shapeshifting": like one character morphing from one appearance into the other, not characters replacing each other. See if you're interested in having it look that way.
:::[[User:Geyser|geyser]] 16:03, 12 August 2008 (CEST)
::::No idea about the story behind the [http://web.archive.org/web/20201029095131/http://oni.bungie.org/forum/viewtopic.php?id=508 white (+ not reflective) BGI guys]. Better ask Ed (they are on his oni name space).
::::'''empty rectangular areas''' I can only think about the dream diver's last room then. You have to remind me in more detail if you want other rooms. ^_^
::::'''set all random body sizes to 1''' Done.
::::'''play animations seamlessly on the characters''' I haven't a detailed idea how they will be animated nor in what formation (triangle, sure?) they will be then but I will try to show you tomorrow new footage.
:::::[[User:Paradox-01|Paradox-01]] 19:12, 12 August 2008 (CEST)
::::"triangle, sure?" - not sure, see above. Square or line are easier to set up than an equilateral triangle, so stick with those if it looks nice already.
::::"if you want other rooms" - places with any environment particles or furniture close to where the characters are... + Omega Bunker + end of Chapter 7...
:::::[[User:Geyser|geyser]] 01:47, 13 August 2008 (CEST)
::::Sorry, it took longer than expected and omega bunker and power failed. The cam ''hits'' obstacles/walls because the animated characters needed a bigger cam radius. That means no particle and lab as location again. There I tried the triangle thing (cam rotates in centre) with a more randomized order. glasshall (fraps raw 64 MB)
:::::[[User:Paradox-01|Paradox-01]] 15:13, 14 August 2008 (CEST)
::::1) the URL is very wrong (but I was able to find the video anyway); 2) I don't have FRAPS installed right now (did you actually buy it, BTW?), so I can't view raw FRAPS footage; 3) I have no plans to install FRAPS right now, unless I decide it's worth buying, so maybe upload a compressed version, please, thanks. --[[User:Geyser|geyser]] 16:43, 14 August 2008 (CEST)
::::Erm, and I don't buy the "camera hitting obstacles" excuse... maybe I don't know what the animated characters are about (for all I care combat stances or taunts were already OK, but maybe you've come up with something more awesome), but there are a lot of camera parameters you can tweak (cm_height and cm_canter_unarmed, but also gs_fov_set(whatever)). As for obstacles, you can usually shoot them down ^_^ --[[User:Geyser|geyser]] 16:48, 14 August 2008 (CEST)
:::::compressed vids -- scrap: omega; scrap: power room; simple and nice: glass hall
:::::'''shooting the rooms''' My player soul tells me that it would look horrible wrong in the vid. Omega has a taste of it, and there still the not fading bullet cases... The movements begin nicely but ends asymmetric. So there was more than one reason to cancel this. There are still a lot other vids that need to be done, right? I don't wanted to waste time with experimenting.
::::: About fraps: someone else bought it for me.. --[[User:Paradox-01|Paradox-01]] 19:38, 14 August 2008 (CEST)
::::::'''I can't view raw FRAPS footage'''. Hmm, I would really think there was a solution for that on the PC. Heck, I'm supposed to be able to play raw FRAPS on my Mac with free software (Perian + QT). It doesn't work only because of a bug in an underlying library. Oh well. I know 'dox was trying to help me out by providing extra high quality video, so I appreciate it. The link for the raw vid no longer works, btw, but I d/led the 3 compressed vids and I like glasshall the most, but the others are interesting too. The obstacles that flash past allow the characters to change "magically" while they are out of sight. That wasn't intentional on your part? Anyway, the quality is high enough to work with, so thanks. If only the footage I was working with last night was that good.
::::::P.S.: What are you using in place of FRAPS, geyser? Taksi? --[[User:Iritscen|Iritscen]] 19:12, 14 August 2008 (CEST)
:::::::Yes, I've removed the raws. (Geyser and you can't use it, why keep it then?) --[[User:Paradox-01|Paradox-01]] 19:38, 14 August 2008 (CEST)
::::::Iritscen, the FRAPS codec is free, but also proprietary, so on PC you typically get it bundled with the FRAPS application. I don't know how your free Mac software is supposed to play it back. Yes, I use Taksi as a sensible substitute and no, I'm not quite happy with the results right now. The FRAPS recorder is very HDD-efficient, and for Taksi to perform nearly as well I need to find a good alternative codec first. I haven't yet tried to record FRAPS-like footage as a series of screenshots: the disk usage will be about the same (maybe even better than FRAPS once you ZIP the BMPs together or make a GIF), and lag will in theory be totally absent from the captured video, but if it lags too much, interactivity during the recording phase may be frustrating. I need to free up some disk space and do a test. --[[User:Geyser|geyser]] 19:21, 16 August 2008 (CEST)
:::::::Well, there's no legal reason why some Program X can't read the file format of some Program Y, so I don't know why you are surprised that there's a solution for the Mac (we're the multimedia people, remember?). Apparently FRAPS ('FPS1' is the four-cc) is an mpeg implementation, so a Unix library called ffmpeg can (supposedly) play it, and so, of course, can programs that implement ffmpeg, like VLC and Perian (a QT plug-in). However, it seems that newer FRAPS videos catch a bug in ffmpeg, which may or may not be fixed soon. --[[User:Iritscen|Iritscen]] 23:03, 16 August 2008 (CEST)
::::::::"there's no legal reason why some Program X can't read the file format of some Program Y" - if Program Y is a commercial, closed-source project, the figuring out the detail of its format typically involves reverse-engineering, which is typically discouraged by the end-user license. As for ffmpeg being able to read FRAPS, I'm not sure what to think. --[[User:Geyser|geyser]] 05:20, 19 August 2008 (CEST)
::::::Dox, you shouldn't use an invisible midget in plain sight: use a few extra commands to place the (non-clipping) player character below the floor, and compensate by increasing the height of the camera target. Also, I would place the characters much closer to each other (not back-to-back-to-back, but almost: as if they were part of a tight circle of six) - then you can bring the camera closer to them and avoid some obstacles and walls (right now, even in the "glass hall" there's a console streaking across the foreground at some point, which is not good). Also, don't forget to adjust cm_canter_unarmed in parallel with cm_height and the FOV: you actually have total control of how the characters are framed and what gets in the way of the camera. In the case of the power room, for example, note that the four pillars are actually pairs of "stalactites" and "stalagmites", with large gaps in between, intermittently filled by the "power" particles. You can obviously take advantage of this by making the camera orbit higher, looking down at the characters through those gaps: that way, there will never be anything solid hiding the characters and the only thing in the foreground will be some cool-looking particles that will add to the "magical" effect. If you want to push this "magical" idea to the limit, you can place the shapeshifting characters ''in'' the gaps (maybe orbit about only one then), on the scanning bed in Kerr's lab, in Shinatama's chair, in place of Zombie Shinatama, etc... You can also give up the idea of orbiting around a static point, and instead do an orbiting close-up on a single character that shapeshifts as it runs down a corridor, performs a cutscene animation or a Trinity Kick or whatever. The possibilities are limitless. Back to the Omega Bunker, you've obviously picked the wrong center (half of the time you're showing Griffin's very dull office, and the walls are narrow so the camera indeed runs into them very easily) - obviously the characters need to be placed at the center of the bunker, with Shinatama's pod lowered (it can be rising during the take, to add some dynamics), but with the hologram particles active. The symmetry of the room suggests to use 4 characters rather than 3, and as for the animations, in this case it's better if the characters don't move around ''too'' much: taunts or "idle specials" (yawning) are fine; you can bring the camera much closer that way. You can, of course, make the shapeshifting characters travel in some direction, but then it's better if they stay grouped, e.g., if they're running together down a corridor/catwalk/bridge. --[[User:Geyser|geyser]] 19:21, 16 August 2008 (CEST)
:::::::I actually enjoyed the "magic" shapeshifting in the Omega Vault as one set of characters goes behind something and another set appears on the other side (it's less interesting to see the characters abruptly change out in the open). It wouldn't take Paradox much more effort, if he starts from the script he used in the Vault, to time it to do that magic trick consistently. The timing's almost there already. --[[User:Iritscen|Iritscen]] 23:03, 16 August 2008 (CEST)
::::::::Paradox will agree that when the camera clips right through walls, the "magical" effect is as lame as lame gets. If the "somethings" are the consoles standing around the vault or the "squid" rails, you could have it look better, but timing the shapeshifting consistently with short occlusions is tricky, and longer occlusions are, again, lame. So, not that I don't like the working principle of Shinatama dolls, but I like the "scramble suit" effect better, thanks. And actually my favorite idea so far is to "scramble" Konoko with female ONCCs during a fast-moving, closely-filmed action sequence (like running up to a ledge and Matrix-jumping off it). --[[User:Geyser|geyser]] 05:20, 19 August 2008 (CEST)
:::::::::''Or'', (and this is easy to do) show Konoko hiding (just standing out of sight) in a room while a patrolling Striker approaches, and playing the checking-her-wrist-communicator animation as if she's activating something, then having her shift through a few female forms until arriving at a harmless one just as the Striker enters. Falling for the disguise, he ignores her (of course, behind the scenes in the script she has to be set to be on his team or neutral so this works). --[[User:Iritscen|Iritscen]] 22:07, 19 August 2008 (CEST)
::::::::::I really like that shapeshifting idea as stealth element but that will focus the camera on the Striker and Konoko for too long. This wouldn't be our needed slideshow anymore. The idea of a single character which performs acrobatics goes into same direction. But in total you came up with enough useful (''and'' complicated) ideas. ^_^ I'll post again when I'm done with this. --[[User:Paradox-01|Paradox-01]] 23:37, 19 August 2008 (CEST)
:::::::::::Here's a new vid. --[[User:Paradox-01|Paradox-01]] 20:54, 3 September 2008 (CEST)
::::::::::::Yay, I like it. Are you thinking that this one is better than the one in the trailer v5? I will replace that one with this one in the next draft if you agree. --[[User:Iritscen|Iritscen]] 23:21, 3 September 2008 (CEST)
:::::::::::::Somehow I'm not fully convinced by vid's close cam (and last Konoko's details variate) but characters are animated there so let's give it a try. The problem will be the caption "more modding power" because characters stands in center now. --[[User:Paradox-01|Paradox-01]] 16:50, 4 September 2008 (CEST)
::::::::::::::"last Konoko's details variate". I don't think it will be noticeable in the trailer. "The problem will be the caption". I can deal with that; if nothing else, I will just move the shapeshifting clip to a point after the words have disappeared. --[[User:Iritscen|Iritscen]] 17:20, 4 September 2008 (CEST)
[[Category:Anniversary Edition]]

BGI characters

2025-12-26T06:11:34Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

This is a series of new characters intended for use in adding the entity [[BGI]] to the game, developed by [[User:Samer|Samer]]. They include either completely new concepts or concepts based on the ideas discussed in [[AE:BGI]]. They all share a common color scheme of white, black, and different shades of green/teal. All the playable characters have customized movesets and green contrails and hit impacts.

==BGI Executives==
*First concept by [[User:Geyser|geyser]] is found [[AE:BGI#Executives|here]].
*In Samer's version these are non-fighting characters, wearing suits and rarely seen in the field, if ever.
*They run BGI, working behind the scenes on grand scales.
[[Image:BGI Executives 1.jpg]]
[[Image:BGI Executives 2.jpg]]

==Sarai==
*[[Sarai]] is a female BGI boss working directly under the Executives' orders.
*More information on the character can be found by clicking on her name.
*Mod available [http://oni.bungie.org/forum/viewtopic.php?pid=46869#p46869 here].
[[Image:Sarai.jpg|640px]]

==BGI Agents==
*These were previously considered the Executives, however in Samer's version these are called the BGI Agents and they are field agents, the equivalent of the Syndicate [[Comm Trooper]].
*These guys usually accompany [[Sarai]] as her henchmen; they are strong and quick in addition to being highly technologically skilled and experts in weapons.
*Mod available [http://oni.bungie.org/forum/viewtopic.php?id=1329 here].
*The mod includes 2 classes, "Lite" and "Blackops", Blackops being an upgraded difficulty class. Each class has 3 variants. (6 variants total)
[[Image:Bgi agents lite.jpg]]
[[Image:Bgi agents blackops.jpg]]

==BGI Hammer==
*This giant cyborg has shock generators at the end of his arms, making contact with his punch almost lethal. His techniques include shockwaves and electrical attacks.
*The character concept was first mentioned by Leus [http://oni.bungie.org/forum/viewtopic.php?pid=19624#p19624 here].
*:(A major influence of the concept was [[wp:Rhino_(character)|Marvel's Rhino]] as seen [http://web.archive.org/web/20210324174207/https://www.renderhub.com/rip-van-winkle/rhino-from-marvel-strike-force here])
*The model and textures are made by [[User:Ltemplar|Ltemplar]].
*Mod available [http://oni.bungie.org/forum/viewtopic.php?id=2490 here].
[[Image:BGI Hammer.jpg]]

==BGI Hydra==
*This female SLD is based on Sarai and would share some of her moveset. Her legs have been mechanically and technologically enhanced giving her the ability to jump high and deliver high damage with kick attacks. Her moveset would include all kick moves, and throws utilizing her legs, with no punches. She would be very fast and agile, but would have low health. She would be considered relatively common, similar to how common furies and tankers are to the Syndicate.
*The character concept was first mentioned by Leus [http://oni.bungie.org/forum/viewtopic.php?pid=19624#p19624 here].
*The design of the character took inspiration from [[Hikari]].
*Mod discussion [http://web.archive.org/web/20160224173752/http://oni.bungie.org/forum/viewtopic.php?id=2936 here].
[[Image:BGI Hydras.jpg]]

==BGI NinjaBot==
*A light and quick BGI Bot.
*Model imported by Samer, original model found [https://downloadfree3d.com/3d-models/weapons/robot/robot-warrior/ HERE] and [http://web.archive.org/web/20210122041553/https://www.domawe.net/2014/09/robot-knight-3d-model-free-download-rf.html HERE].
*:(Later identified as an Accretian Warrior from the MMORPG [https://www.gameogre.com/reviewdirectory/reviews/RF_Online.php RF Online].)
*He has a custom TRAC (mix of Ninja's and Training Droid's (Comguy) moves).
*Mod available [http://web.archive.org/web/20170517033156/http://oni.bungie.org/forum/viewtopic.php?id=2438 here].
[[Image:BGI NinjaBot.jpg]]

==BGI Heavy Bot==
*The general idea of a "BGI heavy" is by geyser, discussed [[AE:BGI#Candidate|here]].
*Model imported by geyser (from an unsourced SketchUp model)
*:(Years later, it was identified as [https://models.spriters-resource.com/pc_computer/unrealtournament2004/asset/286716/ Widowmaker] from UT2004)
*Textures and UV map correction were done by Ltemplar.
*Custom TRAC and slight texture modifications by Samer.
*This character was originally referred to as BGI Trooper but this was changed to BGI Heavy Bot, making the BGI Trooper an armored form of BGI Agent.
*Mod available [http://web.archive.org/web/20160224193743/http://oni.bungie.org/forum/viewtopic.php?id=2445 here].
[[Image:BGI Heavy Bot.jpg]]

[[Category:BGI]][[Category:Modding projects]]

Talk:Importing character models

2025-12-26T06:11:13Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

==talk==
'''For TRBS files'''

To export an ONCC or TRBS file to Collada format:
onisplit -extract:dae dest_dir ..\GameDataFolder\level0_Final\ONCCkonoko_generic.oni
This will produce an ONCCkonoko_generic.dae collada file in the directory dest_dir plus the tga texture files used by the specified character.

Note: Blender's Collada importer/exporter is buggy, so you will need to add the options -noanim and -zup when extracting collada files for use with Blender:
onisplit -extract:dae dest_dir -noanim -zup ..\GameDataFolder\level0_Final\ONCCkonoko_generic.oni
-noanim prevents the export of the default idle animation. That's needed because Blender doesn't import animated objects correctly.
-zup exports a collada file with a coordinate system where Z axis points up instead of the default (Y up). This is needed because Blender uses Z up but the importer gets it wrong and convert to something else.

To create a TRBS file, use the following command:
onisplit -create:trbs ..\GameDataFolder\level0_Final ONCCkonoko_generic.dae
This will create the TRBSkonoko_generic.oni file in dest_dir.

Options include
-normals autogenerate normals.
-cel generate a shell to give the effect of cel shading.

Example
onisplit -create:trbs ..\GameDataFolder\level0_Final -normals ONCCkonoko_generic.dae

For more detailed information about importing characters, please this page: [[Importing character models]]

----
So, uh, you can't add a TRBS that you want to test into a folder other than level0_Final, right? I thought I could save time by not having to recompile level0_Final, so I added a TRBS for Griffin that I was testing to level12_Final ("Rooftops"), and it didn't work. The same TRBS worked in level0_Final, so I know it's not the file's fault. I guess only level0_Final loads characters, not the individual levels? This is also true for ONCCs? What about making a plugin with that TRBS.oni file and naming it "level12_griffin"? --[[User:Iritscen|Iritscen]] 19:38, 3 June 2008 (CEST)
:'''The same TRBS worked in level0_Final, so I know it's not the file's fault.''' It's never the file's fault. There are only program bugs and user errors. In your case there seems to be more of the latter, even though it's hard to tell because "it didn't work" is as uninformative as reports get.
:'''I guess only level0_Final loads characters, not the individual levels? This is also true for ONCCs?''' Aren't you tired of guessing wrong? There is no such limitation, never was. The example up there is Edition-oriented, that's all. Don't guess, just say what you did exactly, why doncha?
:'''I guess only level0_Final loads characters, not the individual levels? This is also true for ONCCs?''' Really, dude... The original Oni has no ONCC in level 0, that's why you could shapeshift to most characters in only a few levels. And what the frack do you mean by "characters"? TRBS?
::[[User:Geyser|geyser]] 20:55, 5 June 2008 (CEST)
This may seem hard at first, but once you learn it, it will make life easier for you.
#Get 0xED https://web.archive.org/web/20110101150641/https://www.macupdate.com/app/mac/22750/0xed
#Make a duplicate of ONCCgriffin_generic.oni and rename ONCCgriffin_generi1.oni, now open it with 0xED. Scroll to the end of the file. Look for the text TRBSgriffin_body_high, change it to TRBSgriffin_body_hig1 (Make sure that 0xED is in Overwrite mode: Edit - Write Mode - Overwrite). Save.
#Rename the TRBS you created to TRBSgriffin_body_hig1.oni
#Put both these files in the Level1_Final folder.
#In the Level1_Final folder look for the file BINACJBOCharacter.oni. Open it with 0xED.do a search for griffin. You should get the text griffin_generic, you will need to change that to griffin_generi1. Save.
#Rebuild Level1
#Now modify a script to spawn griffin in Level1

That's it, now whenever you make changes to griffin, it will be quicker to rebuild level1 than level0. Further, since I added a number of character to BINACJBOCharacter.oni, you will have access to EvilKonoko, Shinatama, Muro, etc. So if you ever want to change them, you can follow the above process.

Now I made the changes to the file names very simple. The point of just changing one character in the name using the hex editor is to prevent the file from changing its size. (In the file itself, there is a number which tell Oni, the size of the file, so if you even add or delete one character, then it will cause a crash, since it is not the correct file size) But in the future, you can make the names more appropriate, by first exporting the ONCC as an .xml file then changing the names of the links to the TRBS, TRMA (textures), TRAC (animations), because OniSplit will calculate the correct file size.

Hope this helps,

[[User:EdT|EdT]] 21:43, 3 June 2008 (CEST)
:I think it does help, thanks Ed. Do I understand this right? Is this going to replace the existing Griffin character with the one I added to level1_Final? But only for level 1, of course. --[[User:Iritscen|Iritscen]] 22:59, 3 June 2008 (CEST)
::Ed's instructions don't technically replace the "existing Griffin character" (of course this depends on what exactly you mean by that). Since the new ONCC and TRBS are not named the same as the original ones, the new stuff and the old stuff will exist alongside each other and never interfere. This is also why Ed has to go to the trouble of modifying BINACJBOCharacter - because the new ONCC does ''not'' override the old one and has to be summoned by its own, different name.
::Personally I think the most straightforward thing to do when testing the visual aspect of a new character is to just import a [[AE:Plugins|plugin]] with the ONCC and TRBS, shapeshift the player and use the manual camera. If you want to see the new Griffin controlled by AI, then make sure the name of the ONCC in the plugin is the ''same'' as the original and that the plugin is loaded ''before'' the level#_Final.dat where the original Griffin is. Take [http://geyser.oni2.net/edition/plugins/level0_Characters.zip THIS] one for example.
::Then you only need to be careful about a few things. Like, if you want your ONCC to be a level0 plugin, then make sure you have globalized all the crucial dependencies of the ONCC (TRMA, TXMP, TRAC, TRAM, TRAS, TRSC). And of course, if you run into trouble, try to file a report so we can tell you where you messed up.
:::[[User:Geyser|geyser]] 20:55, 5 June 2008 (CEST)
:Oh, and Ed: you're saying confused/confusing and possilby wrong things up there about not messing up file sizes. The header of an .oni file doesn't actually know or care about the total file size. The only thing you should care about for an ONCC is the offsets of the names of the dependencies, at the end (one offset for every name). That's where you can't allow to make the name of the linked-to TRBS longer without shifting all the following dependencies of the ONCC and updating their name offsets consistently. As for the name of the ONCC itself, you can rename the file to anything at all, like ONCCgriffin_generic_fubar.oni : OniSplit will ignore the internal name of the root instance and use the filename instead. And as for the ONCC name in [[CHAR]], it's a fixed-size array (char[64]), so virtually any new name will work, as long as you take care of the null char after the ONCC name.
::[[User:Geyser|geyser]] 21:57, 5 June 2008 (CEST)
:::Maybe I'm confused, but, if you look at offset 0x0030 in an ONCC or TRAC .oni file, I thought that offset pointed to the end of the file. For example ONCCkonoko_generic.oni has 8017 and that points to 0x1780, ONCCbarabus is A016 that points to 0x16A0. Also, that's what I documented at [[OBD_talk:TRAC]] and if that point was incorrect, I'm sure someone would have corrected it. So based on that information, I made the statement about not messing up the file size, while using a hex editor. Also, I knew about being able to rename the file to anything else, that's what I did with the files related to the Motoko character.
:::[[User:EdT|EdT]] 23:00, 5 June 2008 (CEST)
----
EdT, you uploaded this picture a while back; isn't it useful in this article (or somewhere?): Image:3D rotationpose.jpg --[[User:Iritscen|Iritscen]] 04:58, 5 October 2008 (CEST)
:Its probably not useful anymore, since Onisplit can now export the character in an upright pose. [[User:EdT|EdT]] 03:57, 6 October 2008 (CEST)
::Well, I will mark for deletion, then; if you change your mind, the image probably won't actually be gone anytime soon. --[[User:Iritscen|Iritscen]] 05:53, 6 October 2008 (CEST)

----
Rewriting of '''AE: Importing character models'''
* Maybe use some stuff Samer wrote [http://web.archive.org/web/20160224202204/http://oni.bungie.org/forum/viewtopic.php?id=2423 over there].
* Let's see where we can use links instead of copying stuff that is already on this wiki.

==exporting a character from Oni==
===step 1: installing needed tools===
* .NET Framework 2 or higher
* Oni Anniversary Edition (AE)
* Vago

===step 2: choosing a pose===
* default orientation
* -noanim pose
* Idle pose
* Any pose

===step 3: doing the export===
* via command line
* via onisplit GUI (Vago)

==creating a character in Blender==

==creating a character in Mod Tool==
===step 1: 19 body parts===
* bring together new stuff or do some bastardizing
* create overlaps
* avoid discountinuties (''blue lines'')
* triangulate the meshes

===step 2: level of detail (LOD)===
* create 5 models differing in level of detail (basically the triangle number)
===step 3: hierarchy===
* move and rotate center
* remove keyframes
* build hierarchy
===step 4: UVs===
* [...]
===step 5: textures===
* [...]
*
===step 6: error check===
* [...]

==importing a character to Oni==
===step 1: TRBS // character 3D model===
* cel-shading
* [...]
===step 2: TRMA // character texture collection===
* [...]
===step 3: TXMPs // character textures===
* [...]
===step 4: ONCC // character main file===
* [...]
===step 5: BINACJBOCharacter // character spawn collection===
* [...]
===step 6: AE package===
* [...]

==additional changes==
===animation contrails: white and colored ones===
===impact effects===
===Daodan stuff===
===sounds===
===?===

[[Category:Modding tutorials]]

AE talk:OTA

2025-12-26T06:11:06Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

This area is for reporting or documenting crashes or other bugs for [[AE:OTA|Oni Team Arena]].

==To-do list==
User "bravebeat" on Discord alerted us to several issues:
*Some levels' OTAs listed [[AE:OTA#Where_do_I_get_it.3F|HERE]] are flat-out missing as AE packages:
::'''OTA 1.0'''
::Science Prison
::Regional State
::Cargo Hangars
::Musashi Manufacturing
::Dream Lab

::'''OTA 1.1'''
::Atmospheric Conversion Center
::Mountain Compound
*The packages on Mod Depot are sometimes v1.1 and sometimes v1.2. What changed in 1.2? Is this even documented? bravebeat says that there are different/missing menus in v1.2.
*Multiple errors in the read-mes. bravebeat says that the F-keys listed for things like "start record" are wrong, plus there is a disconnect between geyser's old read-mes and what is written on the Depot, e.g. missing steps in the Depot read-mes. For details, see the #modding-chat channel in Discord and look at the pinned message where I linked to the start of the conversation with bravebeat.
*You can shapeshift bots to any character, but with globalization in effect, you can choose classes that don't exist in the level natively, so they lack the proper health and melee profile, at least upon respawning.
::It's debateable if this is a bug or a "feature". The only ways to avoid this are not to play OTA in the AE or not to shapeshift to those characters that are not native to the level.
--[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 01:12, 23 March 2021 (CET)

==Crash reports==
:I crashed on compound even with the Daodan dll in. I was using the plugin version of the EXE if it matters
::[[User:Gumby|Gumby]] 00:00, 27 May 2008 (CEST)
:Did you use the cache fix? I don't know if it was fixed in Daodan dll. I know for sure it's fine with the cache fix EXE. It'd be troublesome if the plugin EXE didn't have the cache fix...
::[[User:Your_Mom|Your_Mom]] 10:47, 27 May 2008 (PST)
:Indeed, not many people are aware of the issue with the pathfinding grid cache, and I'm not sure who released the plugin-ready EXE. Could you guys link to it?
:The latest version of the [[Daodan DLL]] takes care of the pathfinding grid cache (and enables plugins, too), so you can use it with the original "Engrish" EXE.
::[[User:Geyser|geyser]] 16:25, 28 May 2008 (CEST)
:Another issue that systematically causes crashes is Loser's latest contribution to the Edition (TRAM hacks). Roll back to the New Year's release and report.
:I feel really sorry for not tracking down those of the upgrades that cause memory corruption, but Loser's TRAM are a lot of stuff to go through. Patience...
::[[User:Geyser|geyser]] 16:25, 28 May 2008 (CEST)
:The plugin EXE was posted by EdT [http://web.archive.org/web/20201029095131/http://oni.bungie.org/forum/viewtopic.php?id=508 here]. The plugin EXE is hosted on Paradox's oni2.net site.
::[[User:Your_Mom|Your_Mom]] 22:55, 30 May 2008 (PST)
:Sorry to interrupt here, but I am working on new version of combat system now, hopefully less bugged. So don't hang with my old stuff, which is not worth your magnifiency, geyser ^_^.
:Also, have you please fixed the last projectile dodge issue?
:P.S.: How many times I will have to write that I HAVE PROVIDED PATCH FOR THAT COMCOMthrow_fw_tgt crash ??? That is like 14th time i see that bug mentioned(altough here it is a bit hidden ^_-).
::[[User:Loser|Loser]] 09:27, 1 June 2008 (CEST)
:Please don't tell me about "magnificiency", that's annoying (no, really, it was fun the first few times, but two years later, it's ''really'' getting old...) ^_^ I just want the Edition to be reasonably non-controversial and crash-free. So in the future it would be nice if your stuff is thoroughly tested for crashes or even slightly annoying features (you know, like when you hit a guy from behind and he falls backwards and dominoes/hurts/kills you). Also try to split your patches in logical groups that can be installed optionally. Then we can really distribute "something everyone can enjoy".
:'''I still can't get a solid fix on Muro's position...he must be using the chaos to cover his escape.''' As for the projectile dodging, we'd love to fix it, but it's harder to find than the projectile awareness bug was. We guess it's the very same kind of bug in the original source, but this doesn't help us when digging through disassembly. So we keep coming back to looking for it, and we'll find it eventually, but no success so far. On another note, we think we know how to enable the sprinting variant for the AI, but we haven't tried it out yet. One thing we ''have'' tried out (but haven't included in the Daodan) is making dying AI keep their MELE, so they can be revived (this allows Oni to keep track of frags and damage dealt, with OTA deathmatch in mind).
:P.S. It's your ''patch'' that's hidden, not the complaints. This is the first time I hear of it, honestly. Remember that I'm staying away from {{OCF}}, so for critical stuff it would be nice if you could post a heads-up here, so I can ''finally'' release a crash-free version of the Edition. The Russians have been complaining a lot about that crashiness, and I really wasn't aware of your patch. Besides, are you 100% positive that COMCOMthrow_fw_tgt was the ''only'' TRAM in your set that caused crashes? Isn't there a SWAT throw as well? Actually, I have doubts about every single one of your throws, because what you do to their RAW parts is not clearly legal, and may cause memory corruption. And memory corruption typically comes up as a crash at a later time, in ways seemingly unrelated to the TRAM that messed up Oni. Please be aware of that when modding: look out for those "delayed" crashes, and make sure you know (or at least document) exactly what you're doing and why.
:On another note, your character/wall collision is pure genius, but sometimes it looks like you spend "too much" time experimenting and "too little" time consolidating the knowledge so far into "something everyone can enjoy". Maybe that's my fault, but we still don't have an "official" upgrade for the CMBT and MELE collections (probably one that adds the new profiles instead of replacing old ones; that's better for modularity and backwards compatibility). It could also be a good idea to start developing applications for the "smart console behavior", the "sidekick" NEUT, etc, not as abstract features but within actual missions (I agree that I probably have to play an active part in this, even if it's only by giving suggestions to others ^_^ ).
::[[User:Geyser|geyser]] 14:15, 1 June 2008 (CEST)

----
==Bug reports==
===Players that just stand and stare===
:This apparently has to do with the number of "duels" that Oni can handle simultaneously. 2x7 players usually work out fine, but for more players it can happen that some characters are singled out and can't start a fight with anyone, because the rest of the players already form a network that has the maximum number of "duels". This could be fixed by making some players forget their opponents, allowing for new awareness/duel links to be created.
::[[User:Geyser|geyser]] 16:25, 28 May 2008 (CEST)

===Read-Me out of date===
:This is minor to us but is bound to be misleading some newbies from time to time: the read-me's Contact info lists an old board address at mukade.bungie.org. At least, that's the case for the Rooftops OTA 1.1 pack. While I'm nitpicking, why is the Feature Highlights section, which explains what OTA actually does, at the very bottom? I imagine you'd want that and the Project Info section to be right up top before the Installation Instructions. Meh. Maybe something to correct before a 1.2 release, if there ever is one. --[[User:Iritscen|Iritscen]] 19:07, 24 August 2008 (CEST)
:The readme was authored during the release of 1.1 for PC, which occurred before the forum moves. Consistently updating the readmes with new links (OCF has moved twice since and might move one more time soon) would have been crazy. I documented the conversion rules for the old forum links [[OniGalore:Community portal|HERE]] '''[These have been removed from the portal page because the archive of the old forum is down. See [[Special:Permalink/24516|this revision]] of the page for the conversion rules he is referring to. -Iritscen]'''. Also, as the people become more aware of OniGalore, it is natural that the accurate contact information should be provided first and foremost here on the wiki, accessible through a quick search for OTA. --[[User:Geyser|geyser]] 00:53, 25 August 2008 (CEST)
:New releases should of course have accurate readmes. In that sense, the inaccurate information merely means that there hasn't been any consistent work on OTA in months and years - practically since Your_Mom discontinued his porting work. And I don't know if there are committed people ready to port OTA across levels today, but the next core from me (if any) will not be 1.2 (don't we already have that one?), but 2.0 or greater, taking in account the Dev Mode features and OniSplit-powered installation. --[[User:Geyser|geyser]] 00:53, 25 August 2008 (CEST)
:The stuff in the readme is listed in the order which naturally occurred to me at the moment of writing: people who download the arena typically couldn't care less about who we are and what we think is cool about the Arena - they're well aware of what it is supposed to look/feel like, and they just want to get it up and running. I might be wrong, but excessive humility on the part of the modder is really the last thing I'd complain about if I was an end-user. That stuff at the bottom? it's for salesmen! --[[User:Geyser|geyser]] 00:53, 25 August 2008 (CEST)

----

==Resolved issues==
===Insufficient pathfinding grid cache===
:This used to cause crashes for battles spanning a few [[AKVA|BNV]]s cumulating too many pathfinding grid squares. Typically, this happens in the TCTF parking lot, in some areas of the Airport, and in some multi-storey areas of the Bio-Research Lab. The fix is either to lock out a few areas (e.g. lock the doors between the TCTF parking lot and the main building) or, ultimately, to increase the size of the pathfinding grid cache. This has been available as an in-place patch for the EXE, and is now handled by the Daodan DLL.
::[[User:Geyser|geyser]] 16:25, 28 May 2008 (CEST)

===Inconsistent pathfinding data===
:The only example of that so far is the main gate of the Bio-Research Lab. Even though it's closed, the pathfinding graph is the same as if it was wide open. Therefore, the AI may attempt to pathfind through it, and Oni may crash when they are blocked by the gate. This used to occur in the acid room: enemies falling to the "garage" side would start running out the garage and around the block and through the main gate and up the aisle and into the lobby and up the stairs and into the acid room again. The obvious fix to this was to lock a few doors.
::[[User:Geyser|geyser]] 16:25, 28 May 2008 (CEST)

[[Category:Obsolete AE mods]]

User talk:EdT/Archive1

2025-12-26T06:10:55Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

:Hi Ed,
:Here's a tentative fix for the mismapped enter key in the OSX port:
:*go to the offset '''0x1B6050'''
:*you should see '''0D 00 00 0A''' (Oni's "enter" bound to external "return")
:*change it to '''0D 00 00 0D''' (Oni's "enter" bound to external "enter")
:It should work. Please confirm.
::[[User:Geyser|geyser]] 04:29, 2 January 2007 (CET)
----

:Second, open your '''key_config.txt''', and make it look something like this:
unbindall

bind w to forward
bind a to stepleft
bind s to backward
bind d to stepright
bind q to swap
bind e to drop
bind f to punch
bind c to kick

bind space to jump
bind leftshift to crouch

bind mousebutton1 to fire1
bind mousebutton2 to fire2
bind mousebutton3 to fire3
bind mousexaxis to aim_LR
bind mouseyaxis to aim_UD

bind fkey1 to pausescreen
bind v to lookmode
bind z to walk
bind leftcontrol to action

bind tab to hypo
bind r to reload
bind fkey12 to screenshot

#bind p to forward
#bind l to stepleft
#bind apostrophe to stepright
#bind semicolon to backward
#bind o to swap
#bind leftbracket to drop
#bind k to punch
#bind comma to kick
#bind enter to walk

bind p to man_cam_move_forward
bind l to man_cam_move_left
bind apostrophe to man_cam_move_right
bind semicolon to man_cam_move_backward
bind leftarrow to man_cam_pan_right
bind rightarrow to man_cam_pan_left
bind rightshift to man_cam_move_up
bind rightcontrol to man_cam_move_down
:Allow for some variations, of course. Adopt, adapt and improve.
:The basic idea is that the left-handed controls ''are'' mapped properly.
:And we never use them. So? let's map them to '''man_cam_...''' instead!
:'''leftarrow''' and '''rightarrow''' are consistent with the auto-bound '''uparrow''' and '''downarrow'''.
:You may want to use '''pageup''' and '''pagedown''' instead of '''rightshift''' and '''rightcontrol'''.

:Note that you'll hardly ever use anything but the equivalent of WASD, i.e.:
:*man_cam_move_forward
:*man_cam_move_left
:*man_cam_move_right
:*man_cam_move_backward
:Why? Because in camera mode 2 (press Enter twice), you can aim up, and then '''man_cam_move_forward''' makes you go up much faster than '''man_cam_move_up''' would. Same for going down.

:The only occasion on which you'll use the other 6 keys is when you want to:
::move the camera away so as to get a nice remote view
::''and'' keep mouse control over Konoko
:That's what camera mode 1 is for. Then you need the whole lot. And you got it.
::[[User:Geyser|geyser]] 16:55, 4 January 2007 (CET)

----
Just wanted to thank you for the work on the modding tutorials (TXMP, adding char.s). That's some really important info. Also, I had a thought about the topic I brought up above, glass-breaking. Since the hack makes the dust particle break glass, can't we mod a move to generate dust if we want that move to break glass? It's still my goal at some point to see a mod that allows Konoko to break glass when she has a weapon in hand, and punches with it. I noticed we have [[OBD:TRAM/raw0x2C|specific documentation]] that shows where an animation can generate a particle. I bet we could just mod that to generate the glass-breaking particle. What do you think? --[[User:Iritscen|Iritscen]] 15:47, 17 April 2008 (CEST)

----
I've been meaning to get the tutorials up, hopefully, it will help others to do more modding.

I think it is a good idea, I found the post with Loser's glass breaking hack:
http://web.archive.org/web/20220524161706/http://oni.bungie.org/forum/viewtopic.php?pid=2856#p2856

[[User:EdT|EdT]]
----
:[http://geyser.oni2.net/edition/characters/cosplay_motoko.zip HERE] is what I meant by more creative choice of body part meshes. She still looks like a cosplayer, but not a completely lame one at that. Obviously I haven't touched the textures at all.
::[[User:Geyser|geyser]] 01:47, 5 May 2008 (CEST)
----
:And another thing. [http://geyser.oni2.net/edition/characters/cosplay_level.zip HERE] you'll find a dat/raw/sep set that you can place in your GameDataFolder (use the ones with the "Mac" suffix; PC dudes would of course use the ones with the "PC" suffix).
:In order for Oni to load those plugins, you have to modify a byte in the engine (both on Mac and on PC). Here are the instructions, let us know if it works on the Mac:
:*for the Mac executable (OMNI):
::go to 0x0E2D19 and change 7A to 9A
:*for the PC demo executable:
::go to 0x021148 and change 00 to 01
:*for the PC retail executable ("standard" a.k.a. "eastern" a.k.a. [http://geyser.oni2.net/EXE/pc.east/ THIS] one):
::go to 0x0206A8 and change 00 to 01
:In case you're wondering: yes, it's a little big revolution. There are a few limitations, but mods will be much more modder- and user-friendly with this feature.
::[[User:Geyser|geyser]] 04:41, 5 May 2008 (CEST)

Wow!

I made the change in the Oni and the plugin loaded as you can see here:
:Got Level Info for level0_CosplayMac.dat.
:Valid Level level0_CosplayMac.dat

EDIT: I see what it does, it loads the cosplay Konoko as a global character.

EDIT2: Are you limited to a single character or could you, for example, make a plugin with all 3 versions of the Masterchief, plus any other new content?

I look forward to more info on how this can be done.

I can see how this will make it much easier for the end user, just put the files in the GameDataFolder and you're done!

Also, thanks for the cosplay model. I still have lots to learn about using the right meshes. But It seems the facets in my Motoko model are a result of the FBX converter. I did another extract of ONCCk4_K and then converted the .dae to fbx. If you're interested, you can see the results here; <nowiki>http://edt.oni2.net/3D/ONCCk4_K.zip</nowiki> (dead link)

[[User:EdT|EdT]] 06:55, 5 May 2008 (CEST)

Wow, geyser, you are full of surprises. I do have to say that it didn't work for me last night. I changed the byte to 9A, verifying that it was 7A to begin with. I put the cosplay .dat/.raw/.sep files in the GDF. But when I loaded a level and used F8, I didn't find any new Konokos. Still, it worked for Ed, so that means I probably just did something wrong. This is really amazing. We demand details! How does this work, what are the limitations, etc. And thanks! --[[User:Iritscen|Iritscen]] 15:28, 6 May 2008 (CEST)
:Ed: As for the FBX conversion, I guess you'll have to tell us what you're converting ''with''. It looks like the model is not completely faceted, but was auto-smoothed with a rather small smoothing angle. You should be able to fine-tune that angle or to switch to full smoothing.
:It's good to hear that the plugin worked for you. There is no limitation as for what a plugin can hold. You can, for example, split level0_Final into several smaller bundles/folders, with modularity and quick import in mind. You can also have level-specific plugins (e.g., OBJC).
:There is, however, a limitation as for the number of .dat files detected by Oni at startup (and also as for the number of .dat files loaded simultaneously). The former limitation is the most relevant to you since OMNI's engine can only "see" 16 .dat files, which is quite minimal.
:Iritscen: try to at least fake some patience, for the sake of our [[friend]]ship. It works simply because the public versions of Oni have an internal test, whereby they only accept "_Final.dat" as valid level files: we've merely disabled that check. And it's not Russian power because I'm just the middleman here.
:As for you not seeing any new Konokos (technically, it's a Motoko we're talking about), Motoko is supposed to be at the very start of the F8 loop (meaning that after enabling shapeshifting you'll get her with F8,Shift+F8 or Shift+F8,F8. You can also check startup.txt to see if the .dat was loaded correctly.
:Once the engine is patched to allow for non-Final files, you can use OniSplit to create [[dat|instance files]] with any name (although you still can't use "_tools" or "_Tools"; there's another check for that, which we consider a minor limitation).
:It is critical that you create the files with OniSplit. Renaming them by hand won't work, because the name of the file is hashed and used throughout the [[dat|instance file]] as a key (BTW, Ed, looks like Dox and you did double work here; sorry).
:Of course, the files are sepness-specific, so if you mean to distribute plugins to both Mac and PC users, you'll have to build a dat/raw/sep set ''and'' a dat/raw set like I did for the example above (and the examples below).
:To get a feel for the possible applications and for the limitations of OMNI's engine, try the following two plugins.
:*a global "BGI" plugin featuring a bunch of Spartans and the tentative machinegun thingie:
::http://geyser.oni2.net/edition/plugins/level0_BGI.zip
:*a local instance file supposed to alter the character lineup in {{C|2}}:
::http://geyser.oni2.net/edition/plugins/level2_OBJC.zip
:If you place both of these in your GDF and then look at the startup file (and at the Load Game dialog), you should notice that level9_Final ( {{C|7}} ) failed to load (and maybe other chapters if you've kept the Cosplay around). That's the 16-instance-file limitation issue. If we can't fix OMNI's engine, you'll have to play Oni one "act" at a time (something like 6 chapters + level0 + plugins).
:All limitations aside, the effect of the plugins depends on the order in which they are listed and on the type of instance inside. The characters and weapon in level0_BGI end up ''before'' those in level0_Final, but it's the BINACJBOCharacter from ''level2_OBJC'' that is used, even though level2_OBJC is loaded ''after'' level2_Final. Not too intuitive, but hopefully there are firm rules that apply here.
::[[User:Geyser|geyser]] 04:53, 8 May 2008 (CEST)
:My problem with the machine gun is that it has non-planar quads triangulated the wrong way (meaning 17secs didn't really do his job as a modeler), and that it has a rather plain look and feel. See it as just an example.
:The Spartans have a few remaining issues (apart from them being stolen from Halo, of course).
:*The downsampled and posterized texture (that can only be fixed by remapping the whole thing; then again, the env mapping does a good job at concealing the ugly bits).
:*The awkward look of the shoulder joints while aiming (that's an Oni-wide animation issue, even if it looks especially bad here; maybe the skeleton needs another polish, too).
:*The environment maps won't look "exactly right" unless there are weighted normals (again, this is a general issue in Oni; unweighted normals = ugly Gouraud and envmaps).
::[[User:Geyser|geyser]] 04:53, 8 May 2008 (CEST)

:::How am I lacking patience? I tried it and it didn't work. There was nothing else for me to try so I reported my problem so you guys could help me. EdT did so by sending me his version of the modded app. Although I think I applied the hack properly, his copy had debugging msgs enabled, and I realized that as I switched characters, it was skipping every other one. Char 1 --> Char 3 --> Char 5, and looping around to hit the even numbers, 2, 4, 6, etc. I still cycled through every character eventually, but didn't see Motoko. Then I realized that if I turned 'shapeshifter' off, it didn't skip characters ^_^' I've always been in the habit of turning it on right after turning on 'killmequick', because it seemed that shape-shifting didn't work properly otherwise. But now it seems to. So, yeah, apparently having shapeshifter enabled twice means each F8 advances two characters, not one. It also skips #0, which is how it identifies Motoko, even when it's doing evensies, apparently because some code thinks that zero is not even, so it starts at 2. But I guess the solution is simply, Don't enable 'shapeshifter' with the Edition. Heh.
:::Re the 16 level limit, I'm no hacker, but that should be as easy to fix as disabling the check for "_Final". It's also much more important than disabling that check. It's a small thing to have to name a mod patch "yadayada_Final" in order to go along with the original name-check system, but it's a real shame if every patch installed knocks out a level of the game. But I would think it would be easy enough to change a '16' to at least a '31' in the code, if it can be found in the first place. Oh well, I look forward to trying those "plugins".
:::--[[User:Iritscen|Iritscen]] 15:59, 8 May 2008 (CEST)

Reporting in... kinda of busy right now, so it will be brief

I was able to load all the levels, none were missing, so it looks like there is no 16 instance file limits. Here's the startup file: http://edt.oni2.net/OniSplit/startup.txt

An army of Spartans, cool.

I used FBX converter by AutoDesk, the one Neo mentioned, there are no options for Collada import or export (At least in the GUI)

When you have time, please post instructions on how to create the instance files, I would like to give it a test.

Iritscen: Once I'm in Dev Mode, all I need to do it press F8 to shapeshift or F7 to cycle weapons, I don't need to enter shapeshfter again.

[[User:EdT|EdT]] 17:00, 8 May 2008 (CEST)

::Okay, that's great news; so maybe we don't need to worry about that level limit. And yeah, Ed, I knew that shapeshifter was supposed to work without entering the specific code, but there was some reason traditionally why I always did that, like the Edition's shapeshifting wasn't cycling backwards when you hit Shift-F8 or something. Maybe I was mistaken, since that works now. --[[User:Iritscen|Iritscen]] 17:42, 8 May 2008 (CEST)

Regarding the 16 .dat files limit: I'd suggest someone check if all levels are actually loading.

[[User:Neo|Neo]]
:Ed, I second Neo's request. You ''did'' say "I was able to load all the levels", but could you please confirm:
:*that you can indeed load and play every one of Oni's 14 chapters
:*that the "army of Spartans" (and cosplay Motoko) is available globally
:*that the character lineup in Chapter 2 is modified as expected (Barabas at the start and Muro at the end)
:I mean, the 16-dat limit is a major issue to us, so we can't accept it's gone without a thorough check.
:About the Collada-FBX conversion, well, it's a shame that Autodesk's converter has no custom settings.
:However, Cheetah almost certainly allows you to recompute the normals, so that the FBX has no facets.
:Then there's a chance that the resulting FBX will be converted back to Collada without any trouble.
:If Autodesk's converter introduces automatic smoothing on the way back, too, there'll be a problem.
:Perhaps the best way around it is to let OniSplit autogenerate normals (there's a -normals tag now).
::[[User:Geyser|geyser]] 19:39, 8 May 2008 (CEST)
:Iritscen, '''shapeshifter''' is totally redundant of the DevMode. Maybe you used to have problems with Shift+F8 because of the Shift key not being bound or something. Anyway, glad it works for you now. One thing, though. There's no reason why the "double shapeshifter" should ignore 0, so you may want to double-check that. As a matter of fact Oni doesn't care about anything being "even" there, and it ''just'' acts as if you kept pressing F8 twice in a row. So I kinda doubt your report about 0, sorry.
:By "patience" I merely meant that you could have avoided "We demand details!". I ''know'' it's not serious, but ''you'' know I hate that crap. You don't need to fake enthusiasm like that, and if it's not faked, then you have a problem ^_^
:As for your suggestion about "yadayada_Final", you don't really know what you're talking about. The "_Final" the engine used to check for is supposed to come ''right after'' the "level#" sequence, and '''level0_yadayada_Final''', for example, is ''not'' a "_Final" name (neither is '''level0_Final_yadayada''')
:The 16 can't be changed easily, or else we (me and the ''expert hacker'' I represent) wouldn't have been so alarmed/pessimistic about it. We ''do'' know where it is, but if it wasn't for the lucky fact that the 16 is somehow ignored, you would have had to load and play Oni one "act" at a time, most likely.
::[[User:Geyser|geyser]] 20:16, 8 May 2008 (CEST)
:::Sorry to interject, but I didn't realize that OniSplit could generate normals. They're smoothed? Also, is it at all possible that the Mac does not have the same limitation as the PC version? It could even be a difference in the width of the variable that is declared, on the Mac vs. the PC. Just throwing that out there. --[[User:Iritscen|Iritscen]] 19:51, 8 May 2008 (CEST)
:The -normals option was requested (by me) some time ago, but only appeared in the latest not-quite-release of OniSplit (0.9.9). It only works for TRBS right now, and still needs some checking.
:These normals are totally smooth and "angle-based": the vertex normal is a weigthed sum of the normals of all adjacent faces, the weight being the angle of every face's corner at that vertex. This weighting provides much more accurate normals than an unweighted sum, and hence better-looking Gouraud shading and environment mapping.
:As for the limitation, it is of course different on PC and on Mac. On PC, there's no 16 anywhere to see: we can have 512 .dat files in GDF at Oni startup and 64 can be loaded simultaneously. The 64 limit is apparently the same on every version, but the 512 limit is a 16 on Mac and PC demo, apparently ignored (so, no limit?).
::[[User:Geyser|geyser]] 20:16, 8 May 2008 (CEST)
:::Or does that mean 64 is the limit? I will test this myself when I get the opportunity. --[[User:Iritscen|Iritscen]] 20:31, 8 May 2008 (CEST)
:No, technically, 64 is about the simultaneously ''loaded'' instance files, not the ones detected at startup. Like, level0_Final and 31 level0_ plugins, and then level9_Final and 31 level9_ plugins (that said, you no longer need to have a _Final file at all. the names can be anything).
:Oh, and I see I forgot do address Ed's question about how to make those plugins. I already told you. They're ''just'' files built the usual way, with -import:sep or -import:nosep. The only difference is that the target name no longer has to be level#_Final. No changes at all apart from that.
::[[User:Geyser|geyser]] 20:51, 8 May 2008 (CEST)

Sorry, didn't enough time to test all levels when I posted my original comment.
:All levels loaded and can be played except for Level 8 TCTF Headquarters. Thus 17 instances loaded? 0-16?
:Spartans and cosplay are global
:Character lineup has changed with Barabas and Muro

Anything else I should test?

Too many things going on in real life...
[[User:EdT|EdT]] 22:44, 8 May 2008 (CEST)
:Please confirm: does '''startup.txt''' look like the one you posted previously (all 18 .dat files listed and reported as valid)?
:What about level8 a.k.a. Chapter 6? What can you say about the way that it "can't be played"? Not visible in Load Game?
:What about level9 a.k.a. Chapter 7? Could it be that you've skipped it when testing all the levels? Please check again...
::[[User:Geyser|geyser]] 03:51, 9 May 2008 (CEST)
:Hm, I'm testing with the PC demo and I get a behavior similar to yours, Ed. Here's what I'm doing (Neo, you too, listen up).
:I generated [http://geyser.oni2.net/edition/plugins/level0_Crap.zip A BATCH OF level0_Crap# FILES] from the chaingun thingie and managed to saturate GameDataFolder with them.
:First, the results with a clean demo (with only level0_Final, level1_Final and level4_Final in GDF to start with)
:*If I put all 16 Crap files into GDF (that makes 16 + 3 = 19), Oni exits (no Blam) while "loading level 0..."
:*If I only use 15 Crap files (that makes 15 + 3 = 18), Oni lets me play level 4, but Blams upon loading level 1.
:*If I only use 14 Crap files (that makes 14 + 3 = 17), Oni lets me play level 1, but Blams upon loading level 4.
:*If I only use 13 Crap files (that makes 13 + 3 = 16) or less, Oni starts normally and lets me load either level.
::(in all these cases startup.txt lists all present .dat as valid, and all the expected ONWCs are available)
:Now, with the extra level (with level0_Final, level1_Final, level2_Final and level4_Final in GDF to start with)
:*If I put all 16 Crap files into GDF (that makes 16 + 4 = 20), Oni exits (without a Blam) while "loading level 0..."
:*If I only use 15 Crap files (that makes 15 + 4 = 19), Oni ''still'' exits while "loading level 0...", this time ''with'' a Blam:
::(here's the message given by the Daodan DLL in this case; I didn't bother with the level-load Blams)
loading level 0...

Oni crashed…
Please post your “startup.txt” file to <http://oni.bungie.org/forum/>…
Caught exception 0xc0000005 at 0x004244ce…
EAX = 0000000000, ECX = 0x0027e201, EDX = 0x08000001
EBX = 0x0054fc20, ESI = 0x0c2b6028, EDI = 0x0c2b6028
EBP = 0x00bfab20, ESP = 0x0012f590
:*If I only use 14 Crap files (that makes 14 + 4 = 18), Oni lets me play levels 1 and 4, but Blams upon loading level 2.
:*If I only use 13 Crap files (that makes 13 + 4 = 17), Oni lets me play levels 1 and 2, but Blams upon loading level 4.
:*If I only use 12 Crap files (that makes 12 + 4 = 16) or less, Oni starts normally and lets me load all three levels.
::(in all these cases startup.txt lists all present .dat as valid, and all the expected ONWCs are available)
:So it appears that 16 is indeed the threshold for normal behavior.
:Fails to load last file for 17, pre-last for 18, doesn't run at all for 19+.
:This is consistent with Ed's report, so I guess this all holds for the Macs.
:For the record, PC retail runs normally with all 16 crap files and then some.
:It's really a shame, but it looks like the Mac build was born to nag us...
::[[User:Geyser|geyser]] 03:51, 9 May 2008 (CEST)

: To confirm, only the TCTF Headquarters level will start to load then Oni will crash. I also tested it on my Intel computer, same result.
: Here is the crash log: http://edt.oni2.net/OniSplit/PluginCrash.txt

[[User:EdT|EdT]] 05:20, 9 May 2008 (CEST)

"(Neo, you too, listen up)". Already did the test :). I split level0_Final.dat into 19 files and now the PC Demo doesn't even start. Reason: the filename of the 17th file got corrupted so it cannot find the file. That's why I asked someone with a Mac to check if the levels really load.

[[User:Neo|Neo]]

It's probably unnecessary for me to report this, but yes, my Intel Mac also also crashed when it tried to load the 1st TCTF level (when I had three plugins in the GDF). I can confirm that the (very nice-looking!) Spartans are present, although I forgot to test the chaingun. And Barabus is an unexpected surprise in Chapter 2. But yeah, crash-a-rama with the TCTF HQ.

So it looks like we have three options as far as the Mac goes:
# Change the '16' (which is not easy, apparently)
# Only use this method for basic crucial patches to the Edition or generally global effects like adding the Spartans
# Compiling more and more patches into the same one or two plug-ins, and releasing those newer versions of the plug-ins, to replace the older versions

P.S.: Please don't be oversensitive, geyser; you dropped in with blockbuster information and gave us no details on its workings, of course I said, "We demand details!" I hope you know that, at least to a native English speaker (which I often forget you aren't because your English is so good), "We demand __!" would not be interpreted as a strict command, but a friendly enthusiastic request. At least between familiar acquaintances it means that; perhaps a smiley would have helped convey my tone of voice.

P.P.S.: I don't fake enthusiasm, geyser, it's all real :-D
--[[User:Iritscen|Iritscen]] 15:59, 13 May 2008 (CEST)

----
When using the level0_BGI plugin and the modified Oni.exe with a "normal" installation of Oni (Not AE) only one Masterchief (Striker version) will appear and he will be 1/2 black 1/2 transparent.

Script_10K first reported it and paradox-01 confirmed it. Video from Script_10K http://edt.oni2.net/AE/Script10K_MC_bug.WMV

EDIT: I just confirmed it with the Mac Demo, only the Striker version appears partly transparent. Since I'm using the demo when shaping shifting to the other MC version, I get the error message "master_muro had a NULL animation collection"

[[Image:MC_transparent.jpg]]

[[User:EdT|EdT]] 00:53, 25 May 2008 (CEST)
:Thanks for the reports.
:"only one Masterchief (Striker version) will appear" As you can see, Oni complains about character classes that specify an invalid TRAC. Actually, since there's no such thing as a "default TRAC", every ONCC that links to a non-existent TRAC is ignored. Apart from the Striker variant, all the Chiefs use fancy male TRAC that can only be found in specific levels, as we well know. Since level0 instance files are loaded before everything else, those global Chiefs need their TRAC to be global. That means that without AE's globalization, indeed, only the Striker Chief will be available with this plugin. I don't think it's worth fixing.
:"and he will be 1/2 black 1/2 transparent." That's because of another resource I'm assuming to be global, namely [[TXMP]]SUPER_REFLECT (Mukade's envmap texture). This is a bit more limiting because TXMPSUPER_REFLECT is missing from the demo (then again, so are a couple of TRAC used in level0_BGI), so even the Edition won't fix the Chiefs in the demo right now. I guess I'll fix that eventually, probably by including a reflection texture with the pack. For now, either play a full version, with AE's globalization of both TRAC and TXMP... or hex-fix level0_BGI.dat, e.g., by replacing the TXMPblack_chief_lo_res at the end with TXMPw5_sbg_ref or such.
:On a completely different note, the [[OniSplit]] page is not exactly up-to-date, is it? I know I can do it myself, but since you were doing all the XML testing I thought you were in a better position than me to mirror and link to the new versions ^_^
::[[User:Geyser|geyser]] 03:47, 25 May 2008 (CEST)

----

::Hi EdT, I have a question. Recently I am toying with 3d models, but I cannot IMPORT them back into Oni (It simply won't create M3GM back from my modified 3d model). Can you please tell me some programmes + what to do?. Big thanks, Loser

Loser: Are you saying that OniSplit cannot import the model or that once its inside Oni, it doesn't work?
A couple of things to check, do you have the latest version of OniSplit? Is the 3D model highly detailed, if so, Oni will crash when the object comes into view.

You might want to look at this tutorial: [[Importing_character_models]]

Its hard to say what the problem is without seeing the model. Can you post it?

[[User:EdT|EdT]] 14:22, 22 June 2008 (CEST)

----

Hey man, there is something (<nowiki>http://www.paradox.oni2.net/mods/mac_shapeshift_test.zip</nowiki>, dead link) to test for you =)
: (Instructions: delete all compound scripts, put in "test.bsl". The character file is for level19_Final. Hope it works.) --[[User:Paradox-01|Paradox-01]] 20:10, 6 October 2008 (CEST)
:: Muro appeared first then, Barabus a few seconds later. The command "chr_wait_animtype 0 jump" had no effect. I didn't know you can have more than one character flagged as "IsPlayer" [[User:EdT|EdT]] 20:48, 6 October 2008 (CEST)

:::I don't know why but "chr_wait_animtype .." is needed on PC. (Try to comment it out (#)..) I tried lots of combinations but that's the way it seems to work.
:::Somehow, it is skipped when Muro becomes deleted. The strange thing is that the cam stays focused on Muro even if I delete him, ergo: the cam is floating into nothing... in a piece of a second out of the level.
:::Surely you can go on experimenting on your machine, maybe there are differences. But for now we have finally a way to shapeshift on a mac. --[[User:Paradox-01|Paradox-01]] 21:40, 6 October 2008 (CEST)
::::Ed, there is a second player character in level1, called "konoko", with which you can do the same trick. You can also use '''chr_create 0''' if there is a valid 0 character in the [[AISA]], i.e., everywhere except in the original level7. --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
::::Dox, it works fine as long as Muro is deleted immediately before the new player is spawned. You can simply enter "chr_delete(Muro);ai2_spawn(barabus);" from the console, or you can delay those 2 simultaneous commands with pretty much anything: chr_wait_animtype, sleep, chr_wait health, cm_interpolate_block, chr_has_lsi in a loop... anything. --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
----
:Here is a simple script that should work nicely in the original level18 (posing as Karen) --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
func main {
chr_teleport 0 0
chr_facetoflag 0 0
ai2_spawnall
door_ignore_locks=1
fork disguise
}
func disguise {
dmsg "please do a Devil Spin Kick"
chr_wait_animation 0 KONCOMkick_heavy
sleep 60
chr_delete 0
chr_create 0
}

::Using the above script, Konoko changed to TCTF_Lite, but no matter where I was when I did the Devil Spin Kick, I changed to the TCTF_lite and transported to location 0. Is that how it works on the PC, or do you change at the location of the DSK? [[User:EdT|EdT]] 04:40, 7 October 2008 (CEST)
:::Ed, that's the fundamental limitation of Dox's hack. The fake shapeshifting involves deleting one player character and spawning another. when spawning the new character, the engine has no way of knowing where the old one was, and no reason to take it into account: all that happens is that control and camera focus are transferred to the new player. "Ergo", the position and facing of the new player must be set approximately: in the Mac case, either from [[CHAR]], [[FLAG]] or [[FILM]]. As you can see, this kind of transition will only look good if carefully scripted, either coordinated with trigger volumes and such, or somehow making the warp look less awkward (teleportation or fade-out effect). --[[User:Geyser|geyser]] 05:30, 7 October 2008 (CEST)
:::As for the TCTF Lite (Cop_generic, without shoulderplates, I assume?), that's the way it works with globalized resources, yes. The 0 AISA entry links to a missing ONCC, so Oni uses the first available ONCC instead. This is Karen in the original Oni, ONCCCop_generic in the edition so far, a Spartan or a HD Griffin if you use a plugin, etc. --[[User:Geyser|geyser]] 05:30, 7 October 2008 (CEST)

:Here is one that will work with your modified BINACJBOCharacter in level19 --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
func main {
chr_teleport 0 109
chr_facetoflag 0 0
fork upgrade
}
func upgrade {
dmsg "please jump down to your doom"
chr_wait_health 0 199
chr_delete 0
ai2_spawn barabus
chr_teleport 0 194
chr_facetoflag 0 0
}
:Of course, the upgrade will depend on whether ONCCbarabus is global. -[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
:And of course, this emulation of [[chr_set_class]] is quite limited. --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
:But nevertheless very resourceful, and useful for scripted missions. --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)
:My respects for finding this delete-spawn thing: not intuitive at all. --[[User:Geyser|geyser]] 03:08, 7 October 2008 (CEST)

----
It looks like there's a couple different links to Oni apps in your subdomain, EdT, <nowiki>http://edt.oni2.net/files/OniOSXfix.zip</nowiki> (dead link) and http://edt.oni2.net/files/Oni.zip, and they both work. Unless there's a specific purpose behind this, I think you get where I'm going -- we should consistently point to just one download link that will always be the latest modded app. --[[User:Iritscen|Iritscen]] 16:58, 12 October 2008 (CEST)

[[Category:Userspace]]

OBD talk:ONGS

2025-12-26T06:10:47Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

__TOC__

==talk==
http://web.archive.org/web/20160225133018/http://oni.bungie.org/forum/viewtopic.php?pid=9274#p9274
(idea about new overpower values) (see here for actual project: [[AE:Daodan_overpower_and_upgrades]])

offset 0x04 - is it really the level ID? When I set 01 to 12 nothing change, the settings are still global.
My actual goal is to add settings for a specific level beside the global once. --[[User:Paradox-01|Paradox-01]] 14:29, 29 August 2008 (CEST)
:It might be a field that isn't used by the engine. Suggestion: Try copying it over into level 12's .dat and see if it overrides. [[User:Gumby|Gumby]] 18:36, 29 August 2008 (CEST)
::I tried your suggestion but still no effect. --[[User:Paradox-01|Paradox-01]] 19:51, 29 August 2008 (CEST)
:::Ok, last resort, try removing the one from level 0. [[User:Gumby|Gumby]] 22:28, 29 August 2008 (CEST)

Umm, what are guys trying to do more exactly?

[[User:Neo|Neo]]
:He is trying to make a level specific ONGS. I am thinking that to do that, you need one for every level (because the level0 one overrides any level specific ones), but it all depends on if Oni will read an ONGS from outside of level0. [[User:Gumby|Gumby]] 23:20, 29 August 2008 (CEST)
::Nope, that does not work. ONGS is read only once, at startup. Since at startup only level0 is loaded in memory ONGS cannot be overriden. [[User:Neo]]
:::Ok. But could it be possible to have two sets of setting in this one file (one global and one for a specific level)? --[[User:Paradox-01|Paradox-01]] 00:29, 30 August 2008 (CEST)
::::I doubt it, if it is only read at startup, and there are no places in the file where it mentions other levels [[User:Gumby|Gumby]] 01:06, 30 August 2008 (CEST)
:::::No. The only way this can be done is with some sort of engine hack. [[User:Neo]]
::::::Hmm, ok, would be to time consuming just to mod this. --[[User:Paradox-01|Paradox-01]] 13:15, 30 August 2008 (CEST)

----

Missing fields: does group block count as techique? I'm just wondering because there's only single block so far but both in the melee profile. --[[User:Paradox-01|Paradox-01]] 21:35, 30 August 2008 (CEST)
:I don't know, that's why I added those descriptions even if I don't know exactly what those fields do. Maybe someone puts the pieces together and finds the answer. [[User:Neo|Neo]]

{{OBD}}

File:Matashina - Merry.jpg

2025-12-26T06:10:34Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

;Originally on the OCF thread "[http://web.archive.org/web/20160224190558/http://oni.bungie.org/forum/viewtopic.php?id=193 Konoko Fan Art]", created by Matashina.
;Artist's Comments
:Wish to have more replies this time....

[[Category:Fan art]]

File:Matashina - Welcome to Oni Bar.jpg

2025-12-26T06:10:18Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

;Originally on the OCF thread "[http://web.archive.org/web/20160224190611/http://oni.bungie.org/forum/viewtopic.php?id=188 My fanart of Shinatama]", created by Matashina.
;Artist's Comments
:My fanart of Shinatama

[[Category:Fan art]]

User talk:Guido

2025-12-26T06:10:11Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

So, ... uhm still alive? I'm almost too afarid to ask if you are still there .. and drawing wasterland flowers. Give us a sign if you are in the mood. --[[User:Paradox-01|paradox-01]] ([[User talk:Paradox-01|talk]]) 01:03, 17 May 2015 (CEST)
----
Yes, I am still alive, and I have not given up on this project. Not that I have much time on my hands, to be honest, but at least I am managing to grind up Alex's original script of book 4, and start with some rough paneling.

Hopefully, you'll hear more from me.
--[[User:Guido|Guido]] (Lone wolf mode ON)

:Glad to hear you're still plugging away at it! Hope things are going well with you. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 02:24, 27 May 2015 (CEST)

----
:I'd like to help you out with your user space : since it's more than just one page, with linking and such, it gets messy rather easily.
:For now, just have a look at the changes I made... And check out [[Help:Contents|THIS]], too.
::[[User:Geyser|geyser]] 19:44, 27 September 2006 (CEST)
----
:::Ok...
::[[User:Guido|Guido]]
----
:USE THE PREVIEW BUTTON MORE.
:PLEASE.
::[[User:Geyser|geyser]] 17:15, 25 November 2006 (CET)
----
:Sorry again for my sudden leaving on IRC. If you want to discuss, inform or so ever you can do via email because I don't look often into the forum pm section. :|
:Or, we exchange our ICQ/MSN addresses so I could join some conferences of you and geyser. What do you think?
::[[User:Paradox-01|Paradox-01]] 21:43, 16 September 2007 (CEST)
:If you want to join the conversations between Serguei and me you are welcome. Point is, I have no idea on how things like IMMs work, and what should be done to allow small conference chats. Please, contact Geyser and see how grouped conversations can be arranged. My yahoo messenger ID is quite simple:[myrealname.myrealsurname].
:See you on later then.
::[[User:Guido|Guido]]

==Drawing tips==
:Ok then, the time has arrived. (Hm, you are offline right now so I write it here.)
:You said you can help me out a bit with character drawings. And if you have time to do so take a look [<nowiki>http://www.webspace-invasion.com/jackd/projekt3.htm</nowiki> here] [dead link].
:BTW, can you tell me how to create a good perspective? (The one right now is a mess.)
:Main (project) picture is the pure grey one.
:If you want to know the little context meaning of picture follow the link on the project site.
:A cover the a sub chapter... Well, I just want to do so.
::What do you think of the whole?
:::[[User:Paradox-01|Paradox-01]] 01:23, 7 October 2007 (CEST)
:"A cover the a sub chapter"???
::[[User:Geyser|geyser]] 14:23, 7 October 2007 (CEST)
;Perspective
:Perspective is basically the projection of a 3D world onto a 2D support (paper, computer screen, ...)
:For basic rules and limitations, as well as a few tutorials, see [[wp:Perspective (graphical)|Wikipedia]] and [https://web.archive.org/web/20070714060716/http://mathdl.maa.org/convergence/1/?pa=content&sa=viewDocument&nodeId=477 links] [http://web.archive.org/web/20200105165946/http://www.scottmcdaniel.net/drawing/perspective/perspective.html therein].
::(of course there are other tutorials than these, and Guido will have further tips)
:Apart from generalities, the major problem is with the aspect ratios of objects in a complex scene.
:One thing you can do is make a real scene by arranging real 3D objects in your room: boxes, bottles...
:Then you place your eye where the "camera" would be and instantly see the right scales and projections.
:Another thing you can do is find a photograph of the place you want to render (in your case, Frisco).
:[http://web.archive.org/web/20101126122723/http://mayhem-chaos.net/photoblog/images/sf_golden_gate.jpg HERE] you can see the Golden Gate bridge and its general situation with respect to SF.
::(you can see that the land next to the bridge is basically naked, because it's rocky or whatever)
:[https://web.archive.org/web/20190402163437/http://www.earthinpictures.com/world/usa/san_francisco/golden_gate_bridge.jpg HERE] you can see it from up close, with the nearest building (Fort Point)and a few people.
:The biggest problem with your scene is that you want to show too much in a single shot: uncompatible view points.
:One problem is that the roadway is high above the ground level in the vicinity of the bridge,
::so if your camera is shooting horizontally at the warehouse door and the people in front of it,
:::you may not be able to see the bridge itself, let alone the cars on it, in the same shot.
:The only building that's as close to the bridge as you suggest is apparently [[wp:Fort Point National Historic Site|Fort Point]]
::(and as you can see, the roadway is clearly far above the fort)
:If the fort is not good enough, you could take a less extreme shot at the bridge, [http://web.archive.org/web/20210317184804/http://www.ged.rwth-aachen.de/Ww/people/chris/jpg%27s/Joshua%20Frisco%20St%20Louis%2006/003%20%20Golden%20gate%20and%20harbour%20web.jpg from a harbor district].
::The strait and the bridge over it will be seen in the distance (no cars, sorry), and there'll be warehouses.
:::Of course Google Image may not have the perfect shot for your story (e.g., landfill), but it's a start.
:Another thing you can do is split the drawing into a few different perspectives:
:#a wide situation shot (e.g., closer to the bridge and cars, but focused on the faraway warehouses)
:#a closer shot where you can see the warehouses and the vehicles, people standing, doors opening
:#a final shot where you finally distinguish the features of the characters and other details...
::[[User:Geyser|geyser]] 14:23, 7 October 2007 (CEST)
;Characters
:Not many tips except for practicing a whole lot more.
:Baggy clothes do a good job hiding the anatomy, but...
:*the neck is much too thick; head's OK
:*the left shoe should be in perspective
:*the stylized eyes just don't work here
:(with realistic eyes she'd look great!)
::[[User:Geyser|geyser]] 14:23, 7 October 2007 (CEST)
: > the neck is much too thick; head's OK
::I my opinion the whole body don't fit (so, the neck too). However, I minimized the head around 5%. Result: [<nowiki>http://www.webspace-invasion.com/jackd/Bilder/projekt3/Daya_off_of_work_edit.jpg</nowiki> here] [dead link].
::Because of the eyes, the right (a bit too small) hand and in aspect of practice I'm re-making the picture.
: > the left shoe should be in perspective
::Well, she is supposed to go.
: > Baggy clothes do a good job hiding the anatomy
:: Baggy clothes are comfortable... ;)

::Talk about the scenes later.
:::[[User:Paradox-01|Paradox-01]] 18:45, 7 October 2007 (CEST)
----

==Images==
:As for the roughs : it might be a good idea ''not'' to upload some of them on the wiki.
:Because there's a lot of them and some of them you may want to dismiss pretty soon.
:Also because they can't be renamed, and names like "Kon face 1.jpg" are easily overloaded.
::(dunno, you could/should have called them "experimental" or something ^^)
:If you can get an FTP client, then hosting "exploration" on guido.oni2.net is optimal.
:Then again, thumbnailing and gallerying go so much faster with wiki-based images...
::...yeah, leave them where they are, just try to pick more specific names.
:(I don't mean additional info on the face expression :
::just "Kon face study 1.jpg" instead of "Kon face 1.jpg")
:Commenting on those faces some time this week.
::[[User:Geyser|geyser]] 13:59, 27 November 2006 (CET)

Acknowledged.
::[[User:Guido|guido]] 21:33, 29 November 2006 (CET)
----
:As for the node-related pictures (graphical replies to my talk page entries) :
::I definitely think your talk pages could/should be moved over to the Oni2 namespace
:::as potential nodes of a story (or stories). Script, discussion, actual content.
:Then the page and image names should be somewhat systematic (that will make linking easier).
::(something like Oni2:Node42 as the article name and Image:Oni2node42image1.jpg)
:::(give or take a few spaces in the names ^^)
::[[User:Geyser|geyser]] 13:59, 27 November 2006 (CET)

We may do this, but how do you think we can organize a framework-page for these nodes? Of course you have my blessing.

The nodes we have been discussing so far are not linked each other in a linear way. Connection among nodes should be shown through something like a table
or an input-output matrix... (I am sorry, I got carried away, please forget this one)
::[[User:Guido|guido]] 21:41, 29 November 2006 (CET)

If you have any idea, or you think you can handle it, you have my blessing, of course.
::[[User:Guido|guido]] 21:34, 29 November 2006 (CET)

:Indeed. This is no single, linear progression of events : it's ''all connected''.
:But actually, I think there doesn't ''have'' to be a "framework-page" at all...
:About the double entry matrix : it's not as nice as a flowchart and wastes a lot of space.
:Just as a graph, it is likely to get unreadable past a hundred nodes or so.
:I'd say there's nothing wrong with nodes just linking to each other : no overview.
::(that's how gamebooks work, after all : every page is a "local graph" of sorts)
:Additionally, I think an up-to-date semi-automatic index page of existing nodes will do fine.
::(with descriptions and non-trivial link information transcluded from the nodes themselves)
:I may have to experiment a bit more with hoverbox captions and even graphs
::(if GraphViz produces nice-looking diagrams with default settings, why not?)
:If you're really bothered about the lack of flowchart support right now,
::I can have GraphViz installed. Do you want it? I'm not sure it'd be much more than a toy...
:We ''could'' render flowcharts of whole stories (large, messy graphs), or regions (vicinities of certain nodes).
:That would be a lot of work for no big benefit, though, keeping those graphs up-to-date...
:There's a good chance the graphs will end up unreadable pretty soon, though (I'm repeating myself).
:I'm glad to have "your blessing, of course", of course. ^^
::[[User:Geyser|geyser]] 22:59, 30 November 2006 (CET)
:Oh, and there doesn't have to be a ''single'' storyline out there.
:Conflicting entities, contradictory events. Sequels, prequels, paraquels, whatnot.
:Definitely, no matrix can do the job properly. No global graph, either.
:Every story is best outlined in a textual way.
:Every link of a fancy graph can take the form of a sentence or paragraph,
::that will be more informative and less ambiguous than a flowchart.
:Yeah, something like storylines-in-progress.
:Not sure what we'll call them (tree pages?) but they'll definitely do the trick.
:Bottom line : screw flowcharts; plain-text "framework page"
:And that's it, off to sleep.
::[[User:Geyser|geyser]] 22:59, 30 November 2006 (CET)

----
:On second thought, about those roughs (mostly those of Kon's face)
:If there's enough to comment on (or complain about) on a pic-per-pic basis,
::then of course we can issue those comments on the "image page" ov every pic.
:Then you can either overwrite the pic with a new version, or upload it with a suffix (e.g. "a", "b", ...)
:*If you overwrite the old image, you can keep the old around on an external server.
::(and show it along with the new one, like I did for the tandem ride [[:Image:Guido - Mai Tandem 2.jpg|HERE]])
:*If the image is a new one, its page can inherit the old discussion and/or link to the old page.
:Global comments on a group of images should probably go in some global talk page.
::(same as for the "nodes", I think Mai's character study could/should go over to the Oni2 namespace)
:I understand "Kon" is a nice original touch, but in terms of Google hits it's about as ambiguous as Mai.
:So I'd just put it [[Oni2:Konoko|HERE]], along with [[Oni2:Konoko|THIS]]. See you there. [EDIT. Both suggested pages are one and the same now [[User:Geyser|geyser]] ([[User talk:Geyser|talk]]) 13:35, 24 May 2018 (CEST)]
::[[User:Geyser|geyser]] 13:59, 27 November 2006 (CET)

I am the first one who should complain about my drawings. I am disappointed by what I manage to do these days.
I lack the time, the concentration, and the sharp eye I used to have only half a year ago. Even when I find the time, all I get is just a fuzzy mess of sketches: each of them is just a clumsy reflection of what I've been aiming at. There has always been a gap between my hand and my imagination: today it seems larger than ever. It does not depend on the subject I am focusing on, it has to do with a personal state. I hope I will find a way through it. Sadly there's no one who can show it up to me.
::[[User:Guido|guido]] 21:32 29 November 2006 (CET)
:Take your time, man. And try using the eraser more ^^ << ACTUAL ADVICE
:Or listen to something else than NIN for a change ^^ << STUPID JOKE!!!
::[[User:Geyser|geyser]] 22:59, 30 November 2006 (CET)

::re: tandem
::There's someone else how likes big bikes and black units. =) (taken from: Battle Angle Alita, Last Order 10) [<nowiki>http://www.webspace-invasion.com/jackd/Oni_Galore/Gunnm_(Mukade1).jpg</nowiki> 1] [<nowiki>http://www.webspace-invasion.com/jackd/Oni_Galore/Gunnm_(Mukade2).jpg</nowiki> 2] [<nowiki>http://www.webspace-invasion.com/jackd/Oni_Galore/Gunnm_(Mukade3).jpg</nowiki> 3] [dead links]
::I found the analogy amusing, maybe you will get also this impression..
::The motorcycle might be thieved from Akira but I don't care^^
::His fight abilities "aren't bad" but more interesting is his ideology: he's mentioned as a hardcore anarchist and do not accept any hierarchy.
::That's the point where the analogy ends. In [[Oni2:Truth_Number_Zero|Truth Number Zero]] Mukade is an idealist, fighting for general human values and development in society. Zekka's interest lies in his personal freedom only. I overestimate this in state of my euphoria^^
:::[[User:Paradox-01|Paradox-01]] 18:15, 28 October 2007 (CET)
also tsutomu nihei has a penchant for dark suits and nasty bikes... check biomega, scanlations are available here [http://web.archive.org/web/20071029114337/http://omanga.net/]
:::[[User:Guido|Guido]] 15:30, 4 November 2007 (CET)
::It's perfect for getting nightmares, hehe. Now I've a better imagination of extremely negative alienated Daodan beings. It was also quite inspirational, thanks.
::ps: The girls name is Ion and she adepted to the virus. So she has a dark side inside her - reminds me a bit on the [http://web.archive.org/web/20160224190715/http://oni.bungie.org/forum/viewtopic.php?id=30 iON/NO!]-thread.
:Heck, this is getting cluttered...
:"In Truth Number Zero Mukade is an idealist, fighting for general human values and development in society."
:That's not quite true. If it's the Old Mukade you're referring to, his altruistic ways are far from obvious.
:And as for the New Mukade, he's increasingly alienated, even if he was a rational altruist to start with...
:I guess you can draw a parallel between Zekka and the Old Mukade in his early years as a freelance assassin.
:"The girls name is Ion and she adepted to the virus. So she has a dark side inside her" Gotta have a look.
::[[User:Geyser|geyser]] 18:18, 11 November 2007 (CET)

@Paradox: I am happy you liked Biomega. Nihei has been one of my fav artists so far. Despite his knowledge about anathomy and such is a bit questionable, I think he enjoys the rare gift of creating deep, unforgettable athmospheres, and developing a unique imaginery.
As Geyser told you - in truth number zero - Mukade is a name referring to two *separate* characters. The former draws close to the original concept of oldman and he represents the linking agent between the past order and the birth of Phoenix. The latter is the crafty ninja we all loved (or feared) in Oni. He is fundamentally what you get after a deadly combo of Hasegawa's researches , oldman's brain engrams, and a trial subject with daodan implanted.
::[[User:Guido|guido]] 21:47, 13 November 2007 (CET)
----
:Will you be discontinuing [http://oni2.blogspot.com/ THIS] as announced?
:(Practically, should we terminate the links to that blog?)
::[[User:Geyser|geyser]] 17:14, 27 November 2006 (CET)

:I feel sick, I feel depressed, I hate all I do. and all I know to do in such times is to be self-destructive.
:Apart from that, I got no comments. and noticed how the access counter has been idle for long, too long.
:Anyway I am not going to close the oni2blog for a while (a couple of months at least). In any case I am intended to find a substitute for it.
:Maybe it is time to reconsider the idea of getting an Oni2.net account...
::[[User:Guido|guido]] 21:17 29 November 2006 (CET)
:Welcome to the "disgustipation" club. This is what you get when you "get creative"...
:(I used to have bipolar disorder a lot, and as you know I wouldn't call myself "cured")
:On the subject of self-desctruction, late reply to you :
::if earth has become an evil place because of people, and we cannot escape it, what can we do?
::If we are confined in a place for all our life, and everything is getting worse, what shall we do?
:Quoting Seal, "no we're never gonna survive, unless we get a little crazy"... ''So'' true.
:Those for whom REM sleep is not enough ''have'' to freak out in a way or another to "deal" with reality.
:Practically, there are people who take chemicals and go to shrinks, and those who ought to. Like me. ^^
:And then your only hope is to be your own shrink, to take some distance with respect to your craze.
:That's when you have a chance to come up with a "way through" that doesn't destroy you completely.
::(I didn't realize you were quoting Reznor, not Frost, with that sig of yours...)
:Nice work, Guido. This is becoming an agony column. Or group therapy. Or something...
:You're always welcome on oni2.net. Alloc's contact info is on the main page of the server.
:Hope that helps. Expect a mail either before, during, or after this weekend ^^
::[[User:Geyser|geyser]] 22:59, 30 November 2006 (CET)
:Oh, BTW : seen "No one lives forever#Killer quote"?
::"Well, admitting you have a problem is the first step, I suppose. - I like to think so."
:Rather fitting to the private hells of a few people I know...
::[[User:Geyser|geyser]] 22:59, 30 November 2006 (CET)
----
:guido
:I like the Black ops Konoko!
::[[User:EdT|EdT]] 04:11, 1 April 2007 (CEST)
:
:
Great pic (rendezvous). [[User:Ssg|Ssg]] 20:48, 20 December 2007 (CET)
Thank you, Ssg. As you already know I won't be active for quite a long while. However don't think I am leaving the OC community with no artists! Someone else is going to take my place, younger but surely talented and with new fresh ideas. [[User:Guido|Guido]] 12:35, 22 December 2007

It's a pitty that you're leaving. Nevertheless, when you feel up to visit the community in the future, just drop by. As everyone you're always welcome.

Thank you for your contributions. [[User:Ssg|Ssg]] 13:06, 22 December 2007 (CET)

I also enjoy your contributions, Guido, and don't be so hard on yourself. Some people love everything they do, even when it's crappy. You, on the other hand, are very talented, so at least try to find a happy medium where you have ''some'' pride in your work. :-)

Hope to see you around again when it is not a burden on your schedule, and check "Talk:Images#Konoko_V_Art" for my response to your last post. My "art" is meager and amateurish, but I would be honored to provide anything that can be fodder for a true artist. --[[User:Iritscen|Iritscen]] 21:37, 25 March 2008 (CET)

Thank you Iritscen. Hold on, some important deadlines are coming close for me. The end of my phd might be either painful or worthless mentioning, but I hold real hopes that I will be able to move back to Planet Oni after then.
::[[User:Guido|Guido]]

[[Category:Userspace]]

Oni-likes and engine ports

2025-12-26T06:09:52Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

After playing and replaying [[Oni]], fans often ask what other games are like Oni. Although none are a total match for Oni's gameplay, this article lists:
* games with high similarity to Oni,
* games with some similarity, and
* games inspired/influenced by Oni.

At the end, we document past attempts by fans to recreate Oni in several different game engines.

==Oni-like games==
The games in this list meet the following three criteria: (1) third-person action, (2) gunplay (defined as some kind of ranged weapons being commonly in use), and (3) deep melee (combat system has more than basic punches/kicks, e.g. combos and throws). See the next table for games that have some similarities to Oni but don't meet all these criteria.

{| class="wikitable sortable"
!Name
!Year
!Platform
!Female hero
!Cyberpunk(-ish)
!Anime-style
|-
|[[wp:Æon Flux (video game)|Æon Flux]]
|2005
|PS2
|Yes
|Yes
|No
|-
|[[wp:Alias (video game)|Alias]]
|2004
|PS2, Xbox, Win
|Yes
|No
|No
|-
|[[wp:Bayonetta|Bayonetta 1–3]]
|2009–2022
|PS3–4, X360–XB1, Wii U–Switch
|Yes
|No
|Yes
|-
|[[wp:BloodRayne|BloodRayne 1–2]]
|2002–2004
|PS2, Xbox<ref name="BloodRayne">Remastered versions of the BloodRayne games were released in 2020 for Windows as BloodRayne/BloodRayne 2: Terminal Cut and in 2021 for PS4, PS5 and XB1 as BloodRayne/BloodRayne 2: ReVamped.</ref>
|Yes
|No
|No
|-
|[[wp:Death by Degrees|Death by Degrees]]
|2005
|PS2
|Yes
|No
|Yes
|-
|[[wp:Devil May Cry 3: Dante's Awakening|Devil May Cry 3]]
|2005
|PS2, Windows<ref>A remaster of DMC3: Special Edition was released together with Devil May Cry and Devil May Cry 2 in 2012 as the Devil May Cry HD Collection for PS3 and X360, and then the Collection was re-released in 2018 for Windows, PS4 and XB1.</ref>
|No
|No
|Yes
|-
|[[wp:Devil May Cry 4: Special Edition|Devil May Cry 4: Special Edition]]
|2005
|PS4, XB1
|Yes<ref>The Special Edition adds two playable female characters, Lady and Trish.</ref>
|No
|Yes
|-
|[[wp:Die Hard Arcade|Die Hard Arcade]]
|1996
|PS2, Saturn
|Yes<ref name="gender">You can choose the gender of the player-character.</ref>
|No
|No
|-
|[[wp:Enter the Matrix|Enter the Matrix]]
|2003
|PS2, Xbox, Windows
|Yes<ref name="gender" />
|Yes
|No
|-
|[[wp:Fighting Force|Fighting Force]]
|1997
|PS1, N64, Win
|Yes<ref name="gender" />
|No
|No
|-
|[[wp:Ghost of Tsushima|Ghost of Tsushima]]
|2020
|PS4<ref>A Director's Cut version was released in 2021 for PS5 and in 2024 for Windows.</ref>
|No
|No
|No
|-
|[[wp:Star Wars Jedi Knight II: Jedi Outcast|Star Wars Jedi Knight II: Jedi Outcast]]
|2002
|Mac, Windows<ref>Later ported to PS4, Xbox One and Xbox Series X/S.</ref>
|No
|No
|No
|-
|[[wp:Star Wars Jedi Knight: Jedi Academy|Star Wars Jedi Knight: Jedi Academy]]
|2003
|Mac, Windows<ref>Later ported to PS4.</ref>
|Yes<ref name="gender" />
|No
|No
|-
|[[State of Emergency]]
|2002
|PS2, Xbox, Windows
|Yes<ref name="gender" />
|No
|No
|-
|[[wp:The Matrix: Path of Neo|The Matrix: Path of Neo]]
|2005
|PS2, Xbox, Windows
|No
|Yes
|No
|}

==Oni-comparable games==
These games don't meet all the criteria above for an Oni-like, but they still have similarities that may interest an Oni fan.

{| class="wikitable sortable"
!Name
!Year
!Platform
!Female hero
!Cyberpunk (-ish)
!Anime-style
!Third-person
!Deep melee
!Gunplay
|-
|[[wp:Batman: Arkham Asylum|Batman: Arkham Asylum]]
|2009
|PS3, X360, Win<ref name="Batman">Remastered and re-released in 2016 for PS4 and XB1.</ref>
|No
|No
|No
|Yes
|Yes<ref name="contextual">The combat system is much more contextual than Oni's. "Contextual" means that the attack used is based on the physical relation of the player-character to the enemy – their relative positioning, distance, velocity, height – rather than on the specific input of the player. The main character will not launch an attack if the enemy is not in reach, and the attack used is determined by the engine, not the player.</ref>
|No
|-
|[[wp:Batman: Arkham City|Batman: Arkham City]]
|2011
|PS3, X360, Win<ref name="Batman" />
|Yes<ref>Catwoman has her own campaign as a playable character.</ref>
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Batman: Arkham Knight|Batman: Arkham Knight]]
|2015
|PS4, XB1, Win
|Yes<ref>Partially; the game alternates between control of male and female characters.</ref>
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Buffy the Vampire Slayer (2002 video game)|Buffy the Vampire Slayer]]
|2002
|Xbox
|Yes
|No
|No
|Yes
|Yes
|No<ref name="guns">Guns or other ranged weapons are used in a limited way but the focus is on melee.</ref>
|-
|[[wp:EOE: Eve of Extinction|EOE: Eve of Extinction]]
|2002
|PS2
|No
|No
|Yes
|Yes
|Yes
|No
|-
|[[wp:Ghost in the Shell: Stand Alone Complex (2004 video game)|Ghost in the Shell: Stand Alone Complex]]
|2004
|PS2
|Yes
|Yes
|Yes
|Yes
|No
|Yes
|-
|[[wp:God Hand|God Hand]]
|2006
|PS2
|No
|No
|Yes
|Yes
|Yes
|No
|-
|[[wp:Gunnm: Martian Memory|Gunnm: Martian Memory]]
|1998
|PS1
|Yes
|Yes
|Yes
|Yes
|Yes
|No
|-
|[[wp:Heavy Metal: F.A.K.K. 2|Heavy Metal: F.A.K.K. 2]]
|2000
|Windows
|Yes
|No
|No
|Yes
|No
|Yes
|-
|[https://www.wolfire.com/lugaru/ Lugaru]
|2005
|Mac, Windows
|No
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Metal Gear Rising: Revengeance|Metal Gear Rising: Revengeance]]
|2013
|PS3, X360
|No
|Yes
|Yes
|Yes
|Yes
|No<ref name="guns" />
|-
|[[wp:Mirror's Edge|Mirror's Edge]]
|2008
|PS3, X360, Windows
|Yes
|No
|No
|No
|Yes
|Yes
|-
|[[wp:Mirror's Edge Catalyst|Mirror's Edge Catalyst]]
|2016
|PS4, XB1, Windows
|Yes
|No
|No
|No
|Yes
|Yes
|-
|[https://overgrowth.wolfire.com/ Overgrowth]
|2017
|Mac, Windows
|No<ref>A female character model can be swapped in as the player-character using the built-in developer tools.</ref>
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Remember Me (video game)|Remember Me]]
|2013
|PS3, X360
|Yes
|Yes
|No
|Yes
|Yes<ref>The melee is complex, but combo chains are assembled in menus, not performed ad hoc.</ref>
|No
|-
|[[wp:Sifu (video game)|Sifu]]
|2022
|PS5, XSS/X, Win
|Yes<ref name="gender" />
|No
|No
|Yes
|Yes
|No
|-
|[[wp:Star Wars Jedi: Fallen Order|Star Wars Jedi: Fallen Order]]
|2019
|PS4–5, XB1–XSS/X, Windows
|No
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Star Wars Jedi: Survivor|Star Wars Jedi: Survivor]]
|2023
|PS4–5, XB1–XSS/X, Windows
|No
|No
|No
|Yes
|Yes<ref name="contextual" />
|No<ref name="guns" />
|-
|[[wp:Tekken 4|Tekken 4]]
|2002
|PS2
|No
|No
|Yes
|Yes<ref name="tekken">Although Tekken games are 2D fighters and would not normally be listed here, these specific titles have a mode called Tekken Force (Tekken 4), Devil Within (Tekken 5) or Campaign Mode (Tekken 6) where combat takes place in a free-roaming 3D environment. These are all broadly referred to as Tekken Force mode. Tekken Force mode debuted in Tekken 3 but in that game it was presented as a sidescrolling beat-'em-up rather than true 3D free-roam. Tekken 8 only has a brief free-roam mode in the campaign's Chapter 10.</ref>
|Yes
|No
|-
|[[wp:Tekken 5|Tekken 5]]
|2005
|PS2
|No
|No
|Yes
|Yes<ref name="tekken" />
|Yes
|No
|-
|[[wp:Tekken 6|Tekken 6]]
|2009
|PS3, X360
|Yes<ref name="gender" />
|No
|Yes
|Yes<ref name="tekken" />
|Yes
|No<ref name="guns" />
|-
|[[wp:Wet (video game)|Wet]]
|2009
|PS3, X360
|Yes
|No
|No
|Yes
|No
|Yes
|-
|[[wp:Urban Chaos|Urban Chaos]]
|1999
|PS1, Windows
|Yes
|No
|No
|Yes
|Yes
|No
|-
|[[wp:Urban Reign|Urban Reign]]
|2005
|PS2
|Yes<ref>Female characters can be unlocked and used in Free mode.</ref>
|No
|No
|Yes
|Yes
|No
|-
|[[wp:Wanted: Dead|Wanted: Dead]]
|2023
|PS4–5, XB1–XSS/X, Win
|Yes
|Yes
|No
|Yes
|No
|Yes
|-
|[[wp:Yakuza (franchise)|Yakuza 1-6 + 0]]
|2005–2016
|PS2–4, XB1
|No
|No
|Yes
|Yes
|Yes
|No<ref name="guns" />
|-
|[[wp:Zeiram|ZeiramZone]]
|1996
|PS1
|Yes
|Yes
|Yes
|Yes
|Yes
|No
|-
|[[wp:Zeno Clash|Zeno Clash]] 1–3<ref>The third title is called Clash: Artifacts of Chaos.</ref>
|2009–2023
|X360–XSS/X, Win, PS3–4
|No
|No
|No
|Yes<ref>Each title has a different mix of third-person and first-person combat, with the titles becoming more heavily third-person over the course of the series.</ref>
|Yes
|Yes
|-
!Name
!Year
!Platform
!Female hero
!Cyberpunk (-ish)
!Anime-style
!Third-person
!Deep melee
!Gunplay
|}

==Oni-inspired games==
These games, and thus their sequels, directly took inspiration from Oni's combat system during development, though in Lugaru's case the inspiration was somewhat contrary because the developer, David Rosen, did not like Oni's free, non-contextual combat and sought to make a game that would be fully contextual.<ref name="contextual" /> If a game in this list has been released, it will also be found in one of the above tables.

*Star Wars Jedi Knight II: Jedi Outcast and its sequel Star Wars Jedi Knight: Jedi Academy
*Lugaru and its sequel Overgrowth
*[https://raptagonstudios.com/hub/reikoneo-hub/ Reikoneo] (in development)
*[https://spine.game/ Spine] (in development)

[[Image:Influence on Jedi Outcast.png|thumb|center|626px|Comment by a developer of Jedi Outcast under an Oni video on YouTube.]]

==Engine ports==
These were attempts to create a new "Oni" in a more modern game engine.

{| class="wikitable sortable"
!Name
!Engine
!Under development
|-
|[http://web.archive.org/web/20201029113001/http://oni.bungie.org/forum/viewtopic.php?id=3117 Ion Eyes]
|Unreal Engine 4
|No
|-
|[[Konoko Payne]]
|Flexine
|No
|-
|[https://www.youtube.com/watch?v=j0v-hZZ_ofk Oni Deathmatch Multiplayer]
|GoldSrc
|No
|-
|[https://github.com/HoaxMovAxBx/Oni-Round2 Oni-Round2]<ref>Fork of original project that resided at <nowiki>https://github.com/6opoDuJIo/Oni-Round2</nowiki> (dead link).</ref>
|Unity
|No
|-
|[http://web.archive.org/web/20201127171917/http://oni.bungie.org/forum/viewtopic.php?id=3199 OniBGE]
|Blender Game Engine/UPBGE Eevee
|No
|-
|[[Serious Konoko]]
|Serious Engine 2
|No
|-
|[[UnrealOni]]
|Unreal Engine 4
|No
|}

==Footnotes==
<references />

[[Category:Fan-made games]][[Category:Real World]]

Oni-likes and engine ports

2025-12-26T06:09:45Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

After playing and replaying [[Oni]], fans often ask what other games are like Oni. Although none are a total match for Oni's gameplay, this article lists:
* games with high similarity to Oni,
* games with some similarity, and
* games inspired/influenced by Oni.

At the end, we document past attempts by fans to recreate Oni in several different game engines.

==Oni-like games==
The games in this list meet the following three criteria: (1) third-person action, (2) gunplay (defined as some kind of ranged weapons being commonly in use), and (3) deep melee (combat system has more than basic punches/kicks, e.g. combos and throws). See the next table for games that have some similarities to Oni but don't meet all these criteria.

{| class="wikitable sortable"
!Name
!Year
!Platform
!Female hero
!Cyberpunk(-ish)
!Anime-style
|-
|[[wp:Æon Flux (video game)|Æon Flux]]
|2005
|PS2
|Yes
|Yes
|No
|-
|[[wp:Alias (video game)|Alias]]
|2004
|PS2, Xbox, Win
|Yes
|No
|No
|-
|[[wp:Bayonetta|Bayonetta 1–3]]
|2009–2022
|PS3–4, X360–XB1, Wii U–Switch
|Yes
|No
|Yes
|-
|[[wp:BloodRayne|BloodRayne 1–2]]
|2002–2004
|PS2, Xbox<ref name="BloodRayne">Remastered versions of the BloodRayne games were released in 2020 for Windows as BloodRayne/BloodRayne 2: Terminal Cut and in 2021 for PS4, PS5 and XB1 as BloodRayne/BloodRayne 2: ReVamped.</ref>
|Yes
|No
|No
|-
|[[wp:Death by Degrees|Death by Degrees]]
|2005
|PS2
|Yes
|No
|Yes
|-
|[[wp:Devil May Cry 3: Dante's Awakening|Devil May Cry 3]]
|2005
|PS2, Windows<ref>A remaster of DMC3: Special Edition was released together with Devil May Cry and Devil May Cry 2 in 2012 as the Devil May Cry HD Collection for PS3 and X360, and then the Collection was re-released in 2018 for Windows, PS4 and XB1.</ref>
|No
|No
|Yes
|-
|[[wp:Devil May Cry 4: Special Edition|Devil May Cry 4: Special Edition]]
|2005
|PS4, XB1
|Yes<ref>The Special Edition adds two playable female characters, Lady and Trish.</ref>
|No
|Yes
|-
|[[wp:Die Hard Arcade|Die Hard Arcade]]
|1996
|PS2, Saturn
|Yes<ref name="gender">You can choose the gender of the player-character.</ref>
|No
|No
|-
|[[wp:Enter the Matrix|Enter the Matrix]]
|2003
|PS2, Xbox, Windows
|Yes<ref name="gender" />
|Yes
|No
|-
|[[wp:Fighting Force|Fighting Force]]
|1997
|PS1, N64, Win
|Yes<ref name="gender" />
|No
|No
|-
|[[wp:Ghost of Tsushima|Ghost of Tsushima]]
|2020
|PS4<ref>A Director's Cut version was released in 2021 for PS5 and in 2024 for Windows.</ref>
|No
|No
|No
|-
|[[wp:Star Wars Jedi Knight II: Jedi Outcast|Star Wars Jedi Knight II: Jedi Outcast]]
|2002
|Mac, Windows<ref>Later ported to PS4, Xbox One and Xbox Series X/S.</ref>
|No
|No
|No
|-
|[[wp:Star Wars Jedi Knight: Jedi Academy|Star Wars Jedi Knight: Jedi Academy]]
|2003
|Mac, Windows<ref>Later ported to PS4.</ref>
|Yes<ref name="gender" />
|No
|No
|-
|[[State of Emergency]]
|2002
|PS2, Xbox, Windows
|Yes<ref name="gender" />
|No
|No
|-
|[[wp:The Matrix: Path of Neo|The Matrix: Path of Neo]]
|2005
|PS2, Xbox, Windows
|No
|Yes
|No
|}

==Oni-comparable games==
These games don't meet all the criteria above for an Oni-like, but they still have similarities that may interest an Oni fan.

{| class="wikitable sortable"
!Name
!Year
!Platform
!Female hero
!Cyberpunk (-ish)
!Anime-style
!Third-person
!Deep melee
!Gunplay
|-
|[[wp:Batman: Arkham Asylum|Batman: Arkham Asylum]]
|2009
|PS3, X360, Win<ref name="Batman">Remastered and re-released in 2016 for PS4 and XB1.</ref>
|No
|No
|No
|Yes
|Yes<ref name="contextual">The combat system is much more contextual than Oni's. "Contextual" means that the attack used is based on the physical relation of the player-character to the enemy – their relative positioning, distance, velocity, height – rather than on the specific input of the player. The main character will not launch an attack if the enemy is not in reach, and the attack used is determined by the engine, not the player.</ref>
|No
|-
|[[wp:Batman: Arkham City|Batman: Arkham City]]
|2011
|PS3, X360, Win<ref name="Batman" />
|Yes<ref>Catwoman has her own campaign as a playable character.</ref>
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Batman: Arkham Knight|Batman: Arkham Knight]]
|2015
|PS4, XB1, Win
|Yes<ref>Partially; the game alternates between control of male and female characters.</ref>
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Buffy the Vampire Slayer (2002 video game)|Buffy the Vampire Slayer]]
|2002
|Xbox
|Yes
|No
|No
|Yes
|Yes
|No<ref name="guns">Guns or other ranged weapons are used in a limited way but the focus is on melee.</ref>
|-
|[[wp:EOE: Eve of Extinction|EOE: Eve of Extinction]]
|2002
|PS2
|No
|No
|Yes
|Yes
|Yes
|No
|-
|[[wp:Ghost in the Shell: Stand Alone Complex (2004 video game)|Ghost in the Shell: Stand Alone Complex]]
|2004
|PS2
|Yes
|Yes
|Yes
|Yes
|No
|Yes
|-
|[[wp:God Hand|God Hand]]
|2006
|PS2
|No
|No
|Yes
|Yes
|Yes
|No
|-
|[[wp:Gunnm: Martian Memory|Gunnm: Martian Memory]]
|1998
|PS1
|Yes
|Yes
|Yes
|Yes
|Yes
|No
|-
|[[wp:Heavy Metal: F.A.K.K. 2|Heavy Metal: F.A.K.K. 2]]
|2000
|Windows
|Yes
|No
|No
|Yes
|No
|Yes
|-
|[https://www.wolfire.com/lugaru/ Lugaru]
|2005
|Mac, Windows
|No
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Metal Gear Rising: Revengeance|Metal Gear Rising: Revengeance]]
|2013
|PS3, X360
|No
|Yes
|Yes
|Yes
|Yes
|No<ref name="guns" />
|-
|[[wp:Mirror's Edge|Mirror's Edge]]
|2008
|PS3, X360, Windows
|Yes
|No
|No
|No
|Yes
|Yes
|-
|[[wp:Mirror's Edge Catalyst|Mirror's Edge Catalyst]]
|2016
|PS4, XB1, Windows
|Yes
|No
|No
|No
|Yes
|Yes
|-
|[https://overgrowth.wolfire.com/ Overgrowth]
|2017
|Mac, Windows
|No<ref>A female character model can be swapped in as the player-character using the built-in developer tools.</ref>
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Remember Me (video game)|Remember Me]]
|2013
|PS3, X360
|Yes
|Yes
|No
|Yes
|Yes<ref>The melee is complex, but combo chains are assembled in menus, not performed ad hoc.</ref>
|No
|-
|[[wp:Sifu (video game)|Sifu]]
|2022
|PS5, XSS/X, Win
|Yes<ref name="gender" />
|No
|No
|Yes
|Yes
|No
|-
|[[wp:Star Wars Jedi: Fallen Order|Star Wars Jedi: Fallen Order]]
|2019
|PS4–5, XB1–XSS/X, Windows
|No
|No
|No
|Yes
|Yes<ref name="contextual" />
|No
|-
|[[wp:Star Wars Jedi: Survivor|Star Wars Jedi: Survivor]]
|2023
|PS4–5, XB1–XSS/X, Windows
|No
|No
|No
|Yes
|Yes<ref name="contextual" />
|No<ref name="guns" />
|-
|[[wp:Tekken 4|Tekken 4]]
|2002
|PS2
|No
|No
|Yes
|Yes<ref name="tekken">Although Tekken games are 2D fighters and would not normally be listed here, these specific titles have a mode called Tekken Force (Tekken 4), Devil Within (Tekken 5) or Campaign Mode (Tekken 6) where combat takes place in a free-roaming 3D environment. These are all broadly referred to as Tekken Force mode. Tekken Force mode debuted in Tekken 3 but in that game it was presented as a sidescrolling beat-'em-up rather than true 3D free-roam. Tekken 8 only has a brief free-roam mode in the campaign's Chapter 10.</ref>
|Yes
|No
|-
|[[wp:Tekken 5|Tekken 5]]
|2005
|PS2
|No
|No
|Yes
|Yes<ref name="tekken" />
|Yes
|No
|-
|[[wp:Tekken 6|Tekken 6]]
|2009
|PS3, X360
|Yes<ref name="gender" />
|No
|Yes
|Yes<ref name="tekken" />
|Yes
|No<ref name="guns" />
|-
|[[wp:Wet (video game)|Wet]]
|2009
|PS3, X360
|Yes
|No
|No
|Yes
|No
|Yes
|-
|[[wp:Urban Chaos|Urban Chaos]]
|1999
|PS1, Windows
|Yes
|No
|No
|Yes
|Yes
|No
|-
|[[wp:Urban Reign|Urban Reign]]
|2005
|PS2
|Yes<ref>Female characters can be unlocked and used in Free mode.</ref>
|No
|No
|Yes
|Yes
|No
|-
|[[wp:Wanted: Dead|Wanted: Dead]]
|2023
|PS4–5, XB1–XSS/X, Win
|Yes
|Yes
|No
|Yes
|No
|Yes
|-
|[[wp:Yakuza (franchise)|Yakuza 1-6 + 0]]
|2005–2016
|PS2–4, XB1
|No
|No
|Yes
|Yes
|Yes
|No<ref name="guns" />
|-
|[[wp:Zeiram|ZeiramZone]]
|1996
|PS1
|Yes
|Yes
|Yes
|Yes
|Yes
|No
|-
|[[wp:Zeno Clash|Zeno Clash]] 1–3<ref>The third title is called Clash: Artifacts of Chaos.</ref>
|2009–2023
|X360–XSS/X, Win, PS3–4
|No
|No
|No
|Yes<ref>Each title has a different mix of third-person and first-person combat, with the titles becoming more heavily third-person over the course of the series.</ref>
|Yes
|Yes
|-
!Name
!Year
!Platform
!Female hero
!Cyberpunk (-ish)
!Anime-style
!Third-person
!Deep melee
!Gunplay
|}

==Oni-inspired games==
These games, and thus their sequels, directly took inspiration from Oni's combat system during development, though in Lugaru's case the inspiration was somewhat contrary because the developer, David Rosen, did not like Oni's free, non-contextual combat and sought to make a game that would be fully contextual.<ref name="contextual" /> If a game in this list has been released, it will also be found in one of the above tables.

*Star Wars Jedi Knight II: Jedi Outcast and its sequel Star Wars Jedi Knight: Jedi Academy
*Lugaru and its sequel Overgrowth
*[https://raptagonstudios.com/hub/reikoneo-hub/ Reikoneo] (in development)
*[https://spine.game/ Spine] (in development)

[[Image:Influence on Jedi Outcast.png|thumb|center|626px|Comment by a developer of Jedi Outcast under an Oni video on YouTube.]]

==Engine ports==
These were attempts to create a new "Oni" in a more modern game engine.

{| class="wikitable sortable"
!Name
!Engine
!Under development
|-
|[http://oni.bungie.org/forum/viewtopic.php?id=3117 Ion Eyes]
|Unreal Engine 4
|No
|-
|[[Konoko Payne]]
|Flexine
|No
|-
|[https://www.youtube.com/watch?v=j0v-hZZ_ofk Oni Deathmatch Multiplayer]
|GoldSrc
|No
|-
|[https://github.com/HoaxMovAxBx/Oni-Round2 Oni-Round2]<ref>Fork of original project that resided at <nowiki>https://github.com/6opoDuJIo/Oni-Round2</nowiki> (dead link).</ref>
|Unity
|No
|-
|[http://web.archive.org/web/20201127171917/http://oni.bungie.org/forum/viewtopic.php?id=3199 OniBGE]
|Blender Game Engine/UPBGE Eevee
|No
|-
|[[Serious Konoko]]
|Serious Engine 2
|No
|-
|[[UnrealOni]]
|Unreal Engine 4
|No
|}

==Footnotes==
<references />

[[Category:Fan-made games]][[Category:Real World]]

Oni2:Slaves of War/Overview

2025-12-26T06:09:36Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

==Backstory==
Oni's timeline has already veered away from ours — for instance, we have passed the start of the World Coalition Government (the manual says "2032", but this is [http://web.archive.org/web/20210324174419/http://oni.bungie.org/forum/viewtopic.php?pid=52887#p52887 meant to say] "2012", the same year the Freedom Riots happened), the development of phase technology ([[Quotes/Weapons#ph_stream|first used in 2012]]), and the beginning of the BioCrisis — but it's possible to reconcile all the differences in our timeline and Oni's by tying them to a single point of divergence in history and calling Oni's timeline an [[wp:Alternate_history|alternate history]]. This also makes everything easier to explain to the audience.

Before continuing, an unanswered question from Oni is how Hasegawa could have invented the Daodan Chrysalis. It's way too advanced to be a mere next step in the technology of the time, and he only had up to 3 years to do it, since the [[Quotes/Manual#Konoko|manual says]] Konoko was orphaned (meaning, separated from her dad) at age 3. My approach to the backstory has Hasegawa inventing the ''Chrysalis'' — the implantable form of the Daodan — but not the Daodan itself.

As the basis for Oni's alternate history timeline, my point of divergence occurs in 2000 AD when a scientist in Oni's timeline develops phase technology. This allowed contact between our world and another place. In our timeline, some small difference caused this technology to not be discovered. In Oni’s timeline, while experimenting with the "phase veil", some small seed or seeds of life slipped through into Oni’s world unseen. This foreign life was able to grow even in Earth’s environment because it was Daodan-enhanced; all life is, in this other place.

According to this premise, the atmosphere is becoming toxic not because of industrial pollution (as the fans tend to assume, but is never stated) but because Daodan-enhanced life is coming through the phase veil and taking root here, [https://sf-encyclopedia.com/entry/xenoforming xenoforming] our planet to resemble their home. At first it is only simpler kinds of life, like bacteria and plants, but as those flourish here, larger alien life forms which depend on the simpler life as food are able to live here too.

By 2012, a few things happened as a result. For one, the BioCrisis was serious enough that the WCG had to be formed. The manual states that the purpose of unifying the nations of the world was to avoid the spiraling debt that many were in. In our timeline, some countries are in financial trouble, but in Oni's, the situation was made worse by having to deal with the gradual toxification of the atmosphere, which led to the construction of Wilderness Preserves and Atmospheric Conversion Centers.

After Jamie’s death, Hasegawa analyzed the Wilderness to find an answer as to what killed her and what made the Preserve so dangerous, and he noticed that the same genetic signature/process was occurring in all the hostile/alien plant life. Naming it the Daodan ("[http://oni.bungie.org/forum/viewtopic.php?pid=52760#p52760 troublemaker]"), he then decided that if humans had this same extraterrestrial process inside them, they could adapt to the xenoformed environment in the same way that this life is adapting to (and changing) Earth.

This approach unifies the development of the Daodan Chrysalis, the reason for the WCG and the cause of the BioCrisis, and explains all of this with a single change in our recent past, which is the successful development of experimental phase technology in Oni's world and not ours.

==Premise==
Oni 2 would take place months after Oni ends.

After the events of Oni, the WCG is going to be staggered by the task of rebuilding the ACCs, and things will probably get pretty chaotic. The Syndicate knows at least some of the secrets of the Chrysalis and may try to sell them to the populace since the ACCs that formerly sheltered everyone will take a while to rebuild. And we can also assume that the Rebellion (who, depending on the version of the Oni manual you read, are either hinted at or [[Quotes/Manual#Pre-Mission_Briefing|directly mentioned]]) will see this as an opportunity to fight the WCG.

Konoko (now going by her birth name Mai) will initially think that the Daodan Chrysalis is the solution to the problem, but will learn over the course of Oni 2 that it is actually the gravest threat of all. Her father (who she will be reunited with) still thinks that the Daodan is the answer, putting them in eventual conflict. She will at least temporarily work with the Rebellion while they share the same goals, and familiar faces from Oni will show up as reluctant allies and as old enemies. Additional possible factions include Daodan-powered warlords in the Wilderness, a WCG research group attempting to kill the Wilderness with nanotechnology, a [[Oni2:Slaves_of_War/Factions#Agency_RED|counter-symbiote WCG agency]] headed by Griffin, and Syndicate-funded nations that are breaking away from the WCG.

The nature of the place on the other side of the phase veil will probably be an important component to the plot, explaining why the Daodan Chrysalis is not the panacea that Hasegawa thinks it is. One possibility is that, rather than a random alien environment, the "other side" is actually our distant past — a failed society populated by an alternate branch of evolved intelligent life. As they become aware that "our side" is their future and that this means they are one day going to disappear, they decide to come through the veil and take over the present. Mai is going to have to figure out how to stop this invasion plan and keep those ghosts of the past where they belong.

The only problem with putting the Daodan back where they found it is that Daodan-based life on this side of the veil may depend on the Wilderness to live. An energy network composed of Screaming Cells and other living things could be the source of an Imago symbiote's energy, which leaves the question of what happens to Mai and other symbiotes if the Wilderness is removed from Earth.

Due to the complexity of the story, potential exists for additional Oni sequels, or at least an Oni 3, but the story could also be told in a single game if necessary.

==Themes==
Oni starts us off with a seemingly controlled situation; the WCG is in charge, putting the world into a kind of stasis. On a more personal level, Konoko has been trained as a cop and has an SLD assistant, and that world's all she's ever known. The end of Oni, however, leaves us with everything being turned on its head. Therefore, I think it's natural to be led to the notion of opposites, for both story-following and story-telling reasons:

Oni => Oni 2 
Order-to-chaos => Chaos-to-order

Oni was about a seed of chaos growing in an orderly (controlled) world, and Oni 2 can be about a seed of order (control) growing amidst chaos. While everyone knows that destruction in games is fun, games like Okami have demonstrated that it can also be fun to restore a damaged world.

Oni => Oni 2 
Isolation => Belonging

Oni was about Konoko working alone, losing anyone that she had left to trust, so let's make Oni 2 about working with others as part of a group ("Someone left to trust"). Plus, I'm inspired by Guido's art, in particular '''[[:Image:Guido - Rendezvous.jpg|this piece]]''', which is my favorite. I really want to see Mai be part of a team like that — even if it turns out that not every member of the group is entirely allied or trustworthy....

Oni => Oni 2 (=> Oni 3) 
Technology => Nature (=> Spirit) 

Oni was about a world encompassed by technology, surrounded by concrete, plastic and glass. Oni 2 would open up the game's vista to show the natural world as well, without abandoning the cyberpunk aesthetic in the urban environments. Oni 3, if made, would advance in the direction of "spirit" or energy. The technology shown in the games would also advance from the genre of '''cyberpunk''' (with its focus on distinctly mechanical objects such as robots and cybernetic prosthetics) to '''biopunk''' (biological/genetic manipulation) in Oni 2, and then to '''nanopunk''' (nanotech tools and human augmentation) in Oni 3. In Oni 2, human-made biotech would be used in an attempt to neutralize Daodan hosts, and in Oni 3 nanomachines would also be used, however in the end the Daodan organism would prove superior to everything, and completely unstoppable, except by the symbiotes themselves. If the game series was only going to be a duology and not a trilogy, then I would probably work a modest amount of nanotech into the second game, but the overall story arc would not be as satisfying on this particular level since the idea is to have the Daodan "tried" by successive challenges and rise above them.

==Conflict==
With the above in mind, here are the forms of conflict I would like to focus on:

*Man vs. Man: there's going to be plenty of this kind of conflict all over the world — debates over whether the Daodan is needed or whether it's too risky; how to fight against the Wilderness, potentially with risky countermeasures; fights over land with working ACCs; fights with Syndicate warlords who want a piece of the world for themselves....

*Man vs. Nature: the plot can serve as an analogue to the global conflict between our selfish desires as a race and the needs of the planet; is there no way to co-exist peacefully with the Wilderness, alien though it may be? This is the conundrum that all of mankind is facing, but especially Mai.

*Man vs. Self: Mai feels guilty for the Cataclysm she caused. She's not sure she made the right choice, and after being betrayed by, or at least having to fight, her former agency as well as her brother, she has lost the ability to trust people. Her [[wiktionary:agon|agon]] is her inner guilt and her unwillingness to trust others, but she has to learn to trust and work with the other characters in order to prevent more disasters like the one she had to bring about the last time she worked alone. Finally, she's concerned about how her Imago form will turn out (if we don't have her already at that stage when Oni 2 begins). All of these are internal struggles that weigh down on Mai's psyche.

Additional possible themes are (1) parental relationships — the need for us to become independent of our parents as we develop into our own person, and (2) preparing for the responsibility of parenthood — given that Mai will be reunited with her father, and given that the Chrysalis inside her could be considered a metaphor for pregnancy.

==Gameplay==
Assuming we had the use of Oni's original engine, or had totally reproduced its behaviors, what areas can we work on for Oni 2? What areas of Oni needed improvement? The melee combat is probably the area we'd need to focus on the least, as it is the most polished. Our time would be better spent in areas dictated by Oni 2's story, or by [[Review criticisms|criticisms]] of Oni. Too many bullet points on our feature list will result in another Oni project that takes longer than planned, so let's keep it to a minimum. Here's my suggestions for the bare minimum (see the top of my [[../Design|Design Notes]] for additional possible features):

*Slightly improved melee: now with parrying, grappling, throw escapes.
*Slightly improved mobility: now with ledge-grabbing and more stealth options.
*Slightly improved AI: Enemies can now call or run for help. No blithely walking past KOed comrades when the area is supposedly secured.
*Multiplayer focus: emphasize multiplayer mode as much as the single-player story mode. Consider a co-op story mode as well as competitive and co-op MP levels.
*Power progression: Mai's powers develop over the course of Oni's story mode, like moves are unlocked over the course of Oni.
*Natural environments: this one could be a stumbling block for the Oni engine. We might need to re-write the 3D engine (or incorporate an open-source engine) in order to do complex outdoor scenery. If Mai and co. are supposed to be exploring the Wilderness, then this is an unavoidable issue. One specific concern I have is interactive flora. If you're in the middle of a bunch of bushes, do they actually quiver if you brush against them? Does the character push palm fronds out of their face as they walk? If the plants just sit there as static models, then we have a problem, especially because the Wilderness probably is a bit more lively than our everyday ferns and flowers and trees.
*Replayability: Oni 2 needn't be a long game if we make design choices that encourage the player to replay it. Various ways to extend the life of the game are: shapeshifter, multiplayer, and interactivity during cutscenes (see [[../Design#Free_agency|HERE]] for details).

On the subject of the story mode's length, Oni is approximately 6-8 hours long if you take your time, and speed runs are only an hour long. This isn’t uncommon. Here’s an [https://arstechnica.com/gaming/2011/04/the-incredible-shrinking-game-the-truth-of-game-length-in-the-modern-industry/ article] about how even the biggest games these days are very short. An Oni 2 made by a few fans could be excused for being even shorter, if we take into account MP and the aforementioned replayability factors.

Conversely, we might choose to label the big-budget blockbuster games like ''Uncharted'' and ''God of War'' as the “Hollywood approach” of gaming — creating those huge spectacles takes up a lot of the development process — and then label ourselves “indie filmmakers” by comparison. If we focus on building less ''expensive'' and more ''expansive'' areas as a fighting sandbox to provide hours of basic gameplay, with fewer specially-scripted events, we could conceivably create a game at least as long as Oni. This isn’t to say that we don’t want memorable cutscenes and boss fights, but we probably shouldn’t plan any events that require a lot of special coding just for one scene if we’re aiming for a lengthy game.

==Art style==
More emphasis could be placed on Oni's animé heritage. This could be done with cel shading, though it's difficult to do this right. Even harder would be level design, specifically the texturing, since animé backgrounds are often impressionistic paintings and would not work in a game where you can get close to them.

Alternately, a unique minimalistic look could be designed in a way that is low-cost to develop, such as a look that uses vibrant colors in place of detailed texture work, and uses accurate lighting to create realistic-feeling spaces.

Emphasis can also be placed on memorable settings. Many of Oni's settings are industrial and not very fantastical, or are interesting but illogical, or are large but barren, or have potential but are poorly textured and improperly lit. Putting more effort into creating aesthetically enjoyable spaces for players to explore can be helpful when advertising the game and may encourage more replays of the game.

If it is technologically feasible, we should bring much more life into the world, showcasing natural habitats with strange life in them.

Also, being that Oni is science fiction, more thought should be put into the technology of the world, particularly since Oni's world has been affected by the BioCrisis, which would steer tech development in different directions from our world. Depicting novel technology will make the game world more interesting.

Finally, pertaining to color... 
Oni => Oni 2 (=> Oni 3) 
Blue => Green (=> Yellow)

Oni's logo sets up the color blue as the primary color of the game (though BWest did take steps to reduce the amount of blue actually used in levels), and this is fitting since the focus is on technology, typically represented by that color. Since Oni 2 would add the element of nature, its logo would be green in place of Oni's blue. Oni 3, if made, would use yellow as its thematic color to represent energy, change, and spirit. Of course, yellow is an overwhelming color and is best used sparingly, so it would be a frequent highlight/detail color but would not be allowed to dominate the color palette.

==Loose Threads==
Things from Oni that we want to make reference to or develop on, even if trivially.
*[[:Image:TXMPPOSTER1.png|Hapémask]]
*The [[Quotes/Consoles/level 3a|Marionette project]]
*More advanced [[Quotes/Manual#Tech Note 2|SLD technology]]
*[[Quotes/Manual#Tech Note 2|Rogue SLDs]]
*[[Quotes/Consoles#Picasso_Island|Bertram Navarre]]
*[[Quotes/Consoles#Q-31_Railgun|Q-31 Railgun]]
*[[Deadly Brain]]s
*[[Quotes/Consoles#Black_market_goods|Theta wave scans]]
*[[Quotes/Speech#Really_really_misc_2|Funny]] [[Quotes/Speech#Dr._Kafelnikov|civilians]] and [[Quotes/Speech#The_Glorious_Deadly_Brain_Fight_(sic!)|general]] [[Quotes/Consoles#The_day_after|Bungie-style]] [[Quotes/Consoles#Emergency_overrides|humor]]
*[[Quotes/Consoles#Flatline_Zombies|Flatline zombies]]
*[[Quotes/Speech#Mutant_Muro_(Griffin_dead)|"I have accomplished everything our father dreamed of doing."]]
*From the [[Quotes/Manual|manual]]:
**"An average family can afford a nice place to live, timeshare on a vehicle and a terminal that links them to the WorldNet."
**"The poor wretches who can't afford to live in the cities get as close to the atmosphere processors as they can and eke out a miserable (and dangerous) existence working on the reclamation teams who beat back the corrosive stain of the wilderness."
**"Biotech is to us what nukes were to our great grandparents"
**"cyber drugs"
**"Others claim a connection between the Syndicate and the remnants of the countries erased by the World Coalition Government's land grab."

[[Category:Oni 2]]

BGI

2025-12-26T06:09:27Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

[[Image:BGI_logo.png|128px|thumb|Logo by [[User:Geyser|geyser]] (click for details)]]
'''BGI''' is among the most diffuse entities in Oni, essentially because it was supposed to play a bigger part in the plot than it eventually did.

==Canceled BGI HQ level==
This level was intended as a confrontation with the shadowy BGI, which was later excised from the story as Oni's development ran out of time. Unfinished scripts for this level can be found in [[European Mac releases]] and the [[Oni (PlayStation 2)|PS2 port]]. The scripts contain two fragmentary cutscenes. The first describes Konoko setting a bomb and taking cover, and the resulting explosion. The other cutscene introduces the [[Iron Demon]] that would end up getting cut from the game.

{|
|+'''Only known screenshots labeled as BGI''' (click to enlarge)
|[[Image:BGI1.jpg|320px]]
|[[Image:BGI2.jpg|320px]]
|-
|[[Image:BGI3.jpg|320px]]
|[[Image:BGI4.jpg|320px]]
|}

===Regional State connection===
That architecture looks a bit like the [[Regional State Building]] in {{C9}}, which incidentally is linked to the Iron Demon through [[:Image:Konoko runs from Iron Demon.jpg|this image]] of Konoko being chased by it, and also [[:Image:1999 Trailer ID fight.jpg|this sequence]] from the [[Trailers#1999|1999 trailer]]. The building in that footage looks like Regional State, but maybe it was intended to be BGI? If so, many other pre-beta screenshots (or trailer snapshots) of the RSB architecture could in fact be glimpses of the BGI level.

===TCTF connection===
{{Quotebox|align=none|width=850px|source=--[http://web.archive.org/web/20210309192255/http://oni.bungie.org/forum/viewtopic.php?pid=52737#p52737 Hardy LeBel], 2019|quote=The BGI level turned into TCTF HQ. [...] [A]ll of the levels in the game ultimately ended up being composites of architectural details that were stripped from various other pieces that the architects had made. The screenshots that you have of BGI were part of [an earlier, unused] building, as were a lot of the pieces of TCTF HQ.}}
Perhaps the real resemblance is to TCTF HQ?

===Syndicate HQ===
The number of the level, 16, would place it after Konoko meets with Kerr in Science Prison and escapes from it, and before Konoko returns to the TCTF to confront Griffin – but that's only true if the current story was in place at the time. We know that content was shuffled around late in development – so late that Bungie West couldn't even contemplate renumbering the levels to match the new arrangement, and left gaps all over the place. These gaps are examined in detail under {{SectionLink|Pre-beta content|Cut levels}}.

Of particular interest is that fact that Mountain Compound originally came much earlier in the level order (see {{SectionLink|Pre-beta content|Obsolete}}). Until it was moved to the end of the level order, the second-to-last level in the game would have been BGI at level16 followed by TCTF HQ Redux at level18. Significantly, Alex Okita labeled the four "BGI" images in his art gallery as "[http://jongod.oni2.net/UnarchivedFiles/ONI%20ARCHIVE%201/aic/oni400.html Syndicate headquarters]", implying that the game would end with a one-two punch of destroying the Syndicate HQ and then the TCTF HQ. (More supporting evidence for the Syndicate = BGI connection is found at {{SectionLink|Pre-beta content|BGI HQ}}.)

This implies that the Iron Demon at BGI HQ would be one of the final bosses in the game. The script's mention of a "roof bomb" and massive explosions heralded the destruction of the next-to-last level. The [[Oni/Early Story|Early Story]] ended the entire game with Konoko bringing down a building on everyone's heads, both the TCTF and the Syndicate, but with BGI HQ not being slated as the final mission, it's likely that the story had already changed by the time the BGI level was being scripted.

==Mentions in final game==
===Chung's datapad===
{{:Quotes/Consoles/level_1e}}

===Shuttling contraband===
{{Pullquote|The Syndicate is using the warehouse to shuttle contraband. Chung went underground to gather evidence. He failed to report in this morning. Find him and get me what I need to shut the place down or shut it down yourself.|Griffin|{{SectionLink|Speech|Intro}}|inset=0%}}

One example of the kind of contraband being passed through the warehouse is railgun ammunition:
{{:Quotes/Consoles/level_1a}}

There are also Atmospheric Densifiers (useful for [[STURMANDERUNG]]):
{{:Quotes/Consoles/level_1b}}

Or it could have been something more… "fragile"; how did Musashi Manufacturing receive the human brain used for the [[Deadly Brain]] again?
{{:Quotes/Consoles/level_2a}}

BGI was probably one of the Syndicate's "cleaner" corporations, even if it wasn't ''this'' one which took in the doctors after they did a job for the Syndicate.

===Suspected Syndicate front===
{{Pullquote|Musashi is owned by BGI. According to your latest report BGI is a suspected Syndicate [[wp:Front_organization|front]]. If we can prove the connection we can move against them.|Konoko|{{SectionLink|Speech|Outro}}|inset=0%}}

===Musashi blast doors and BGI vehicles===
{{:Quotes/Consoles/level_19a}}

==Added value==
===Meaning of name===
Quoting [[Hardy LeBel]] from the old [http://carnage.bungie.org/oniforum/oni.forum.pl?read=19685 Oni Central Forum]:
:''I shouldn't tell you this, but BGI was the placeholder name that we started using in the story documents before everything was finalized. It stood for Bad Guys International.

===Status and role===
As can be inferred from Konoko's statements, BGI is some kind of "shadow front": a big industrial consortium (probably multinational) that's pretty much legit, but is nevertheless suspected to deal with the infamous [[Syndicate]].
Whether it actually does and at what level and to what end is again sorta diffuse: is it opportunistic/mercenary, or is it subordinated to Muro?

It's also not clear whether [[Konoko]]'s and [[Griffin]]'s zealous crackdown on BGI is supported by the rest of the [[TCTF]] and [[WCG]]. There's a subtle balance of power between the WCG and the Syndicate, and both sides (especially the WCG) are interested in preserving it. BGI is an ambiguous organization, poised between WCG and Syndicate, halfway between legal and illegal: a third party of its own.

It would seem to [[User:geyser|me]] that even as the core of Muro's Syndicate got corrupted by [[Muro]]'s [[wikt:megalomania|megalomania]] and the [[STURMANDERUNG]] perspective, BGI managed to retain the spirit of the pre-Muro Network and Syndicate: they stayed focused on steady business, as opposed to maniacal violence and global biological terrorism.

As long as it helps shuttle the Syndicate's contraband, BGI actually stabilizes the bipolar structure. The Syndicate keeps itself busy and feels in power; the TCTF get a chance to reinforce their credibility as crime-fighters. Same for weapons, and the insecurity they generate: conflict helps the WCG to constantly reestablish itself in the public's eyes as the only alternative to chaos.

Naturally the people behind BGI would be aware of that stabilizing role, and it would actually be quite understandable that the prospect of an all-out crisis (collapse of WCG's authority, anarchy brought about by [[Muro]]) should keep them "doing the Devil's work": obstinately promoting skirmish-scale violence looks like the only way to keep Oni's world together.

===Another idea===
After the [[Syndicate]] is contaminated by [[Muro]], since BGI are favorable to stability and so is the [[WCG]], what makes sense is a pact between the two. The WCG can not undergo militarization at the same rate as Muro's Strikers, but it can turn a blind eye at BGI and even encourage the creation of (perfectly illegal) technology supposed to deal, in time, with whatever threat Muro represents (cyborg supersoldiers rivaling [[Barabas]], Muro and [[Mukade]], weapons rivaling the [[WMC]]). Thus the WCG doesn't technically have an army, but it counts on the unofficial BGI rather than on the [[TCTF]] to stabilize the situation. [[Griffin]], however, is unaware of these developments and thinks the only chance to restore balance is to "fight fire with fire", i.e., to make [[Konoko]] into the same kind of human weapon as Muro is. The WCG can't let Griffin know about the pact with BGI and will thus seek other ways to disrupt the [[Daodan]] project, either through investigations questioning the project's ethics and safety, or through sabotage. And of course things will ''really'' go wrong when Konoko encounters and disrupts the very entity that was supposed to counter Muro: BGI. (This concept is elaborated on in [[User:Iritscen|my]] plan for [[User:Iritscen/BGI|a BGI level]].)

===Real BGIs===
There is a real-world entity named [[wp:BGI Group|BGI]], founded in 1999, which works with the human genome and other genetic data.

There's an unrelated [https://bgigroup.ca/projects-1 BGI Group] which constructs massive buildings in the U.S., Canada and Panama.

There was also a real-world company named [https://web.archive.org/web/20250926063314/https://www.bgiworldwide.com/ BGI Worldwide Logistics], no relation to [[User:Iritscen/BGI/Overview|this]].

Lastly, let's not overlook [https://binarygroup.com/ Binary Group, Inc.], which does… something we're not entirely clear on. "Transformational initiatives"? The fact that they have a connection to the '''DoD''' while also doing "'''[https://www.theguardian.com/world/2013/jun/09/edward-snowden-nsa-whistleblower-surveillance Asset]''' Management" makes them extra-shady.

[[Category:Added value]][[Category:BGI]]

Windows Shell Extension

2025-12-26T06:09:11Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

In Windows you can right-click a file to show a context-menu and choose from various options.

There can be customized options for specific file types if you add registry keys to both '''HKEY_CLASSES_ROOT''' (or '''HKEY_LOCAL_MACHINE''').

Originally, [http://web.archive.org/web/20160226095407/http://oni.bungie.org/forum/viewtopic.php?pid=10487#p10487 Gumby wrote such a shell extension] but it refuses to work on some systems. Either Windows 10 needs HKEY_LOCAL_MACHINE as well or other registry settings of other programs are interfering.

==Setup for oni. file type==
'''HKEY_CLASSES_ROOT'''

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\.oni]

[HKEY_CLASSES_ROOT\.oni\shell]

[HKEY_CLASSES_ROOT\.oni\shell\OniSplit_or_OniSplitGUI]
@="Command name to be displayed in context menu"

[HKEY_CLASSES_ROOT\.oni\shell\OniSplit_or_OniSplitGUI\command]
@="\"C:\\PATH\\Batch_for_OniSplit_or_OniSplitGUI.exe\" \"%1\""

'''HKEY_LOCAL_MACHINE'''

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.oni]

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.oni\shell]

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.oni\shell\OniSplit_or_OniSplitGUI]
@="Command name to be displayed in context menu"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.oni\shell\OniSplit_or_OniSplitGUI\command]
@="\"C:\\PATH\\Batch_for_OniSplit_or_OniSplitGUI.exe\" \"%1\""

==Setup for .xml file type==
Since .xml is a widly used file extension there seem to be additional settings had override the default lookups for better management.

The .xml key at HKEY_LOCAL_MACHINE\SOFTWARE\Classes has a '''Default value (redirect)''' with "'''xmlfile'''".

If you remove the xmlfile value then Classes\xmlfile will be looked up nonetheless. (Doublecheck on other machines.)

So, next reg path to modify is this:

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\xmlfile\shell\OniSplit_or_OniSplitGUI]

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\xmlfile\shell\OniSplit_or_OniSplitGUI\command]
@="\"C:\\PATH\\Batch_for_OniSplit_or_OniSplitGUI.exe\" \"%1\""

==Notes for repair after standard application changed==
When you change xml standard application following gets added and breaks the context menu options:
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.xml\UserChoice]

As soon as you remove this key context menu works again. However this removes the possibility to double-click .xml to open them.

Somthing is still missing.

==Advanced conversions==
If another program handles OniSplit and automatically feeds it with the right arguments you would only need one explorer context menu option such as:

add to OniSplit helper list and process

Some conversions require more than one input file. In that case can collect the other files first:

add to OniSplit helper list

Additional, useful options might be:

repeat last OniSplit helper conversion
clear OniSplit helper list

==Install and uninstall==
A less tech-savvy modder shouldn't need to deal with registry settings.

AEI could be used to distribute an OniSplitHelper tool that manages the registry.

Perhaps "Vago" and "Simple Onisplit GUI" could be adapted to do that.

[[Category:Modding ideas]]

BSL talk:Functions

2025-12-26T06:08:50Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

==table design?==

:geyser, is this about what you wanted?
:I have to do it over again, as I screwed a few things up...
:How do you leave a box empty? Just put a space in?
:Also, the types need listing...
::;The Mystery Man ^_^
[[User:Gumby|Gumby]]
:Dear sir. Either log in or sign, preferably both.
:I'd prefer if signatures were listed in a tidier way.
:(I mean function signatures, not people's sigs ^_^)
:There is currently an example table in the [[sandbox]].
:I wouldn't give one-line examples in such a table...
:Instead, I'd provide console-powered mini-tutorials.
:For example, see what I put here: [[ai2_allpassive]].
:Such a mini-tut is more flexible than a table cell.
:And we'll be basically building a tutorial as we go.
::[[User:Geyser|geyser]] 03:03, 22 January 2008 (CET)
{|border=1 cellspacing=0 cellpadding=1
!Type!!Name!!Arguments!!Description!!Example
|-
| X ||ai2_active||[ai_name:string | script_id:int]||forces an AI into active mode
|-
| X ||ai2_attack||[ai_name:string | script_id:int] [target_name:string | target_script_id:int]||forces an AI to attack another character||ai2_attack IntroNinja 0
|-
| X ||ai2_barabbas_retrievegun||[ai_name:string | script_id:int]||makes barabbas retrieve his gun if it is lost||ai2_barabbas_retrievegun barabus
|-
| X ||ai2_barabbas_run||lets Barabbas run while carrying his gun
|-
| X ||ai2_chump (null)||creates a chump
|-
| X ||ai2_chump_stop||stops the chump
|-
| X ||ai2_comehere||[ai_name:string | script_id:int]||tells an AI to come to the player
|-
| X ||ai2_doalarm||[ai_name:string | script_id:int] [console_id:int]||tells an AI to run for an alarm||ai2_doalarm ambush_commguy_2 4
''if the AI is passive, ai2_doalarm cannot be executed''
|-
| X ||ai2_dopath||[ai_name:string | script_id:int] path_name:string||tells an AI to run a particular path||ai2_dopath A_E3 patrol_49
''if the AI is passive, ai2_dopath cannot be executed''
|-
| X ||ai2_followme||[ai_name:string | script_id:int]||tells an AI to follow the player||ai2_followme s2_t05
|-
| X ||ai2_forget||[ai_name:string | script_id:int] [forget_char:string]||makes one or all AIs forget they saw anything||ai2_forget Sec_Ambush_BOL_1
|-
| X ||ai2_idle||[ai_name:string | script_id:int]||tells an AI to become idle||ai2_idle A1_intro01|||
|-
| X ||ai2_inactive||[ai_name:string | script_id:int]||forces an AI into inactive mode
|-
| X ||ai2_kill||[param1:string] [param2:string]||kills one or more AIs||ai2_kill ScanKerr01 // ai2_kill
|-
| X ||ai2_lookatchar||[ai_name:string | script_id:int] [ai_name:string | script_id:int]||tells an AI to look at a character||ai2_lookatchar 0 Barabus
''needs ai2_takecontrol 1 if Konoko should do that''
|-
| X ||ai2_lookatme||[ai_name:string | script_id:int]||tells an AI to look at the player||ai2_lookatme s2_t05
|-
| X ||ai2_makeaware||[ai_name:string | script_id:int] [target_name:string | target_script_id:int]||makes an AI aware of another character||ai2_makeaware GrifElite04 char_0
|-
| X ||ai2_makeblind||[ai_name:string | script_id:int] on_off:int{0 | 1}||makes a single AI blind||ai2_makeblind ShinShin 1
|-
| X ||ai2_makedeaf||[ai_name:string | script_id:int] on_off:int{0 | 1}||makes a single AI deaf||ai2_makedeaf ShinShin 1
|-
| X ||ai2_makeignoreplayer||[ai_name:string | script_id:int] on_off:int{0 | 1}||makes a single AI ignore the player||ai2_makeignoreplayer ParkStriker 1
|-
| X ||ai2_movetoflag||[ai_name:string | script_id:int] flag_id:int [setfacing:string{"setfacing"}]||tells an AI to move to a flag||ai2_movetoflag 0 1091
''needs ai2_takecontrol 1 if Konoko should do that''
|-
| X ||ai2_neutralbehavior||[ai_name:string | script_id:int] behavior:string||sets up an AI's neutral-interaction||ai2_neutralbehavior neutral_3 none
|-
| X ||ai2_noncombatant||[ai_name:string | script_id:int] non_combatant:int{0 | 1}||sets or clears an AI's non-combatant state||ai2_noncombatant A1_intro01 1
|-
| X ||ai2_panic||[ai_name:string | script_id:int] timer:int||makes an AI panic or not panic||ai2_panic A1_s_red02 300
''I've tried ai2_panic A1_s_red02 300 ==> Oni crashed''
|-
| X ||ai2_passive||[ai_name:string | script_id:int] passive:int{0 | 1}||stops an AI from thinking for itself||ai2_passive Intro_Striker_4 1
|-
| X ||ai2_reset||[reset_player:int]||resets AI as if start of level||ai2_reset||
|-
| X ||ai2_setalert||[ai_name:string | script_id:int] alert:string||sets the alert state of an AI||ai2_setalert Floor2_Striker_2 high (alert strings: lull, low, medium, high, combat)
|-
| X ||ai2_setjobstate||[ai_name:string | script_id:int]||tells an AI to take its current state as its job||ai2_setjobstate E_Er34
''if the AI is passive, ai2_setjobstate cannot be executed''
|-
| X ||ai2_setmovementmode||[ai_name:string | script_id:int] mode:string||sets an AI's current movement mode||ai2_setmovementmode finalam_striker_1 walk (movement mode strings: creep, walk, walk_noaim, run, run_noaim)
''needs ai2_takecontrol 1 if Konoko should do that''
|-
| X ||ai2_spawn||ai_name:string [force_spawn:string{"force"}]||creates and starts an AI from a character object||ai2_spawn ambush_striker_2
|-
| X ||ai2_tripalarm||alarm_id:int [ai_name:string | script_id:int]||trips an alarm||ai2_tripalarm 2 0
|}

: Where is chr_main_class and chr_set_class? Don't they belong on the BSL function page? [[User:EdT|EdT]] 22:14, 24 October 2008 (CEST)
::This is a short table Gumby put together. It's nowhere near complete. The most current stuff is [[Sandbox|HERE]] --[[User:Geyser|geyser]] 00:47, 25 October 2008 (CEST)

==chr_teleport -1==
:<tt>chr_teleport [ai_name:string | script_id:int] flag_id:int - teleports a character to a flag - chr_teleport 0 105</tt>
:Tried today it with -1, <tt>chr_teleport -1 400</tt>, which seems to give random results, but always retrieves a spawned character, I thought it would always retrieve the first character alive after Konoko but seems it isn't always the case. Have anyone had also a look a this? If it was a underflow probably it shouldn't retrieve characters most of the time. --[[User:Script 10k|Script 10k]] 12:55, 8 August 2012 (CEST)

==chr_index vs script_id==
What's the difference between <tt>chr_index</tt> and <tt>script_id?</tt> I think it's that that is messing the things.--[[User:Script 10k|Script 10k]] 16:43, 8 August 2012 (CEST)

:If there's a difference, my guess would be that chr_index is the ONCC order* and script_id the spawn order**.

:<nowiki>*</nowiki> oncc order: installed oncc files, shapeshift to see the numbers.

:<nowiki>**</nowiki> spawn order: first spawned character is 0, second spawned character is 1, and so on. --[[User:Paradox-01|paradox-01]] 17:24, 8 August 2012 (CEST)

I've been playing with <tt>chr_focus</tt> lately, I am sure that that char_index is the spawn order. Haven't checked the ONCC order although. --[[User:Script 10k|Script 10k]] 17:31, 8 August 2012 (CEST)

:Uhm, I confused chr_index with class_index, sorry. (eg ''chr_set_class chr_index:int [class_name:string | class_index:int]'')

:However I checked the ssg's list and it looks like that chr_index is used only be PC retail. *shrugs* --[[User:Paradox-01|paradox-01]] 18:13, 8 August 2012 (CEST)

:EdT can use it on Mac, not sure what version he have? Which one is EdT? --[[User:Script 10k|Script 10k]] 20:59, 9 August 2012 (CEST)

==chr_kill_all_ai==
<tt>chr_kill_all_ai (null) - kills all the AI</tt>, I couldn't get it work. F6 in developer mode works although.

But I've found a good alternative: <tt>ai2_kill();</tt>, kill them all too. By curiosity have anybody got <tt>chr_kill_all_ai</tt> work? --[[User:Script 10k|Script 10k]] 21:00, 9 August 2012 (CEST)

==chr_vocalize==
"chr_vocalize [ai_name:string | script_id:int] type:string - makes a character utter a vocalization (vocalize type strings: override, yell, pain, call, say, chatter, idle)"

Couldn't get this to work with any other character than Konoko (player). If someone can "vocalize" bots please let me know. [[User:Script 10k|Script 10k]] ([[User talk:Script 10k|talk]]) 21:59, 20 August 2016 (CEST)

: Correct me if I'm wrong: AIs spawned by CHAR collection come without an script_id. You would need to add characters via AISA and set <ScriptId>. In case of chr_vocalize, an non-existing script_id is probably replace by 0 and so redirected to player. With CHAR workflow you should use ai_name instead. --[[User:Paradox-01|paradox-01]] ([[User talk:Paradox-01|talk]]) 11:40, 21 August 2016 (CEST)

:: Works like a charm [[User:Paradox-01|paradox-01]]! I've added the character to AISA and it worked as supposed. Thanks! :)
::One thing, in my game the strings available for vocalize aren't the same as described above. They are: "taunt, alert, startle, checkbody, pursue, cower, superpunch, superkick, super3 and super4". Can you check which ones are present in your game?

:::Interesting. You are correct about those being the strings for chr_vocalize. The strings given on BSL:Functions, such as "chatter", are associated with chr_talk, but it seems that they have no effect. So the Functions page is in error. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 17:42, 21 August 2016 (CEST)

::"They are: "taunt, alert, startle, checkbody, pursue, cower, superpunch, superkick, super3 and super4". Can you check which ones are present in your game?" - Yep looks the same in my exe. --[[User:Paradox-01|paradox-01]] ([[User talk:Paradox-01|talk]]) 20:17, 21 August 2016 (CEST)

==chr_holdkey==

"chr_holdkey [ai_name:string | script_id:int] key_name:string num_frames:int - forces a character to hold a key down for some frames"

Couldn't get this one to work too. I tried chr_holdkey char_name "h" but seems character didn't hold the key either the player or the ais. "h" key in my oni is thr keyboard punch key.

Please let me know if any of you got this to work. [[User:Script 10k|Script 10k]] ([[User talk:Script 10k|talk]]) 23:52, 25 August 2016 (CEST)

: SSG (no example in his command list given), geyser, loser and gumby couldn't make that command work. So forget about it ;)
: http://web.archive.org/web/20160225154424/http://oni.bungie.org/forum/viewtopic.php?id=130&p=4
: [[User_talk:Iritscen/Archive2#AI_self-healing]]

: Use '''[[XML:FILM#.3CKeys.3E|FILM]]''' file instead: '''chr_playback_block([ai_name|script_id], film_name, fromhere)'''

: fromhere - ignore the position, rotation is still used interp - interpolates between current character position and film position (awkward when height is not the same)

: You could probably create a level 0 package made of such keys and then use them whenever needed.

: Caution with editing frames, game crashes when done wrong. --[[User:Paradox-01|paradox-01]] ([[User talk:Paradox-01|talk]]) 08:37, 26 August 2016 (CEST)
:: Thanks [[User:Paradox-01|paradox-01]]. I am going to try that.[[User:Script 10k|Script 10k]] ([[User talk:Script 10k|talk]]) 20:05, 28 August 2016 (CEST)

[[Category:BSL docs]]

XML:TRAM

2025-12-26T06:08:15Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{XML_File_Header | prev=TRAC | type=TRAM | next=TRAS | name=Totoro Animation}}
{{integrate|See {{SectionLink||XSI}}.}}

==General information==
TRAM files — animation data for characters — are basically made of three chunks:
* Metadata or "header": animation type, state, flags, particle, sounds, etc.
* Animation data: '''pelvis heights, pelvis velocities (root motion)''', bone rotations
* Attack data: damage, self-damage, extents (danger zones for AI awareness) and throws

Root motion: a character moves by changing the position of its root bone (pelvis). The animated legs just create the '''illusion for the player''' that they are responsible for the motion.

Bones: Each character has '''19 separate body parts''' which get animated (rotated) relative to each other. Compared to modern games Oni's bone system is [[wp:Deprecation|deprecated]]. The body doesn't get deformed by following animated bones. Oni modders often use the terms mesh and bone interchangeably. Only the pelvis has '''translation''' data (heights and velocities) besides rotations. The hierarchy of the body parts (or bones) is determined by [[XML:TRBS#Standard_TRIA_hierarchy|TRIA]].

The term '''animation''' is often shortened to '''anim''' by modders, following the naming of commands in BSL: chr_wait_animstate, chr_wait_animtype, env_anim, etc.

Oni's code and debugging messages tend to spell the word variant as "varient". Blame the programmers for that one. Typically we use the correct spelling here, but OniSplit's XML follows Oni's misspelling, so you may see "varient" creep into the wiki here and there.

TRAMs used in Oni follow a naming pattern. A list of all combat TRAMs in-game and their naming can be found [[Combat moves|here]].

==Open questions==
* If the never-used Thrown type can be applied as type 18 the table looks much more complete. "Restoring" forward tackles (face-to-face, src run + tgt run) can be omitted as the AI would most often stop movement for actual combat?

* All important header data of STRCOMrun_thw_fw_p and STRCOMrun_thw_fw_pl is identical. That means the engine picks the correct TRAM by using an unknown context, possibly this is similar or part of the distinction of "forward" (face-to-face) and "backward" (face-to-back).
: '''Maybe the algorithm checks always tgt's rotation and relative position to src at the same time but for most cases only tgt's rotation (facing) is relevant.'''

* Also, STRCOMrun_thw_fw_p(l) routing to Thrown5 and Thrown6 shows that Thrown anim types might be used however we like. A src-tgt-anim-type-pairing might be simply a ''convention''. Well, someone could check the source code...

* The existence of STRCOMrun_thw_fw_p(_tgt) and STRCOMrun_thw_fw_pl(_t) means that we need extra research to understand the full extent of the throw system.
* The variant pickup system is not clear yet: is a RIFCOM idle and a RIFNAT idle both possible?
** Or do rightpistol, leftpistol, rightrifle and leftrifle variants count as subsets of combat?

==Summary of animation lookup logic==
* First the game builds a pool of anims a character can use. They are loaded from the TRAC file registered in [[ONCC]], including parent TRACs.
* Anims from a child TRAC override those of the parent if their combination of state, type and variant is exactly the same.
* Child TRACs usually omit some anims. For example, Elite Strikers don't have their own run anims, so they use the parent anims of normal Strikers. See [[XML:TRAC|TRAC]] page for details.
* A character always possesses a single animation state. This term derives from state machines, but you only need to know that states are the first point in the decision path determining what anims are actually allowed to play at a given moment.
* Here is the full decision path:
** anim '''state''' check
** event (user input, or engine input for the AI) -> [[XML talk:StNA|context check]] -> anim '''type''' check
** anim '''variant''' check
** TRAC '''weight''' check

===Elaboration===
Animations never stop – they flow from one to another. (See the concept of [[wp:Finite-state machine|state machines]] in gaming.) The default case is a character getting spawned and then just standing there: he idles forever. This brings us to the core attributes of every animation: '''type, state, variant'''.

Now then, the idle animation does not link to a specific follow-up animation – it rather links to a follow-up ''state''.
: Ironically all anims have a <FromState> and a <ToState> field, but no obvious <CurrentState> which can cause confusion on what the current anim's state actually is. This gives us two options of how to think about the situation: either consider <FromState> as usually being the <CurrentState>, or states exist only ''between'' anims and serve as ''transition rules''.

Linking to a follow-up state allows for multiple choices of what specific anim comes next. An anim is picked up randomly from a pool of valid anims. Their probability or <Weight> is determined by the anim listing in the TRAC – the anim collection (see {{SectionLink||Weights}} for an explanation of exactly how <Weight> is handled).

Anyway, to let an character flow from one anim state to another, the <ToState> is used. Let's say an SBG grenade hits Konoko. The particle's '''damage type''' is '''blownup'''; this and the direction of the incoming damage force an anim of type '''Blownup''' or '''BlownupBehind''' to play, such as TRAMKONOKOblownup1.

Thus, Konoko falls to her back, going into the FallenBack state. The engine picks up the next anim which has <FromState>FallenBack. Also, receiving damage puts a character into combat mode, so further anims will be of variant Combat. But if the player gives no input, Konoko will remain on the ground, as <ToState>FallenBack creates a loop.

So here's a question: why isn't a getup anim like KONCOMgetup_lt played automatically since it also has <FromState>FallenBack and <Varient>Combat? Answer: it differs in its <Type>. Most [[XML_talk:StNA|anim types are bound to user input]] and therefore are excluded from the automatically created pool of valid anims which can follow.

Now let's consider what happens upon user input. A leftward movement of the mouse tells the engine to use an anim of type StandingTurnLeft. There are two anims with that type, KONOKOcomb_turnlt and KONCOMgetup_lt, but only the latter matches the current <FromState> condition.
: In fact, KONOKOcomb_turnlt has <Varient> Combat – the "comb" here stands for "combat", not "combo". Following Oni's naming convention, the file ''should'' have been named KONCOMturn_lt.

Knowing this behavior, we can deduce that anim types registered to user input will make the engine ignore all the automatic anims inside the pool, therefore breaking the loop of KONCOMfallen_back. And since KONCOMgetup_lt has <ToState>Standing and Konoko is still in combat mode, the following idle anim must also have <Varient>Combat. So the next anim played will be KON'''COM'''idle1 or KON'''COM'''idle2.

Konoko will eventually calm down when her ONCC <FightModeTimer> runs down, and then KON'''OKO'''idle1 or KON'''OKO'''idle2 will be played instead. (Actually, the COMidle will continue until a non-combat anim such as running breaks that loop. You won't ever see Konoko drop from combat readiness to her regular idle animation. Instead she will go from combat idle to running, to stopping, then standing at ease.)

Note the fallback behavior of anim lookup: if the engine cannot find an anim for the active variant (or "mode") of the character, it will choose the normal (non-variant-matching) version. Anims can be in the following variants: Combat, LeftPistol, LeftRifle, Panic, RightPistol, RightRifle and Sprint.

As for combinations of variants, it's possible, yes, but rarely and only Sprint and one weapon variant at a time.

==Weights==
Let's say that we're playing as a Ninja, we are in the state Standing, and we hit the action key to perform a taunt. The engine recognizes the context (no console to interact with), places the character in combat mode, and looks up anims of type Taunt. Since we are in combat mode, the next anim must be of variant Combat if possible. These lookups boil down to two valid possible anims: NINCOMtaunt1 (a spin) and NINCOMtaunt2 (the [[wp:Moonwalk (dance)|moon walk]] Easter egg). The engine picks one of them randomly.

However, NINCOMtaunt1 has a TRAC Weight (probability) of 100 while NINCOMtaunt2 has a TRAC Weight value of just 5. So the chances are quite high that we will not see the moon walk taunt.

<TRACAnimation>
<Weight>100</Weight>
<Animation>TRAMNINCOMtaunt1</Animation>
</TRACAnimation>
<TRACAnimation>
<Weight>5</Weight>
<Animation>TRAMNINCOMtaunt2</Animation>
</TRACAnimation>

If there is only one anim to choose from, it will always play no matter what its Weight, even if it is zero. When it comes to multiple anims being a valid choice, the calculation is: weight of anim / sum of all valid anim weights. For NINCOMtaunt2, this means 5 / 105 = 0.047, or a 4.7% chance of a moon walk.

==Idle timer==
There's a semi-famous Easter egg where [https://www.youtube.com/watch?v=qbo2Q-VD6dc Konoko will sneeze] if she stands still for a long time. The timer for this is so long that most players never see it unless they step away from the game and leave it running without hitting F1. You might think that the way the sneeze is triggered is to set a low weight for it so that it's very unlikely a repeating idle cycle will choose the anim. But here's the sneeze anim in the TRAC with a Weight of 100:

<TRACAnimation>
<Weight>100</Weight>
<Animation>TRAMKONOKOidle_spec3</Animation>
</TRACAnimation>

What's going on here? All regular idle anims are in fact of '''type Stand''', while Konoko's idle_spec3 anim above is of '''type Idle'''. Anims of '''type Idle''' are played every time the idle animation timer expires. This is found in ONCC as <IdleAnimation1Timer> and <IdleAnimation2Timer>. These timers are set to 30,000 for every character. The number is in ticks, so if we convert to minutes – 30,000 / 60 / 60 = 8.3̅ – we find that the secret idle anim for Konoko (or any character) will play every 8⅓ minutes.

==List of tags, types, and flags==
Use the search function in your browser to quickly find a tag.

{| class="wikitable" width=100%
|width=120px| '''tag'''
|width=100px| '''type'''
| '''description'''
|-
| <Lookup>
| parent tag
|
|-
| <Type>
| flag
| Look them up over [[XML:StNA#Animation_types|HERE]]. The pool of valid TRAMs (animations a character can choose from) is built from the TRAC files registered in the ONCC. Most of the anim types are connected to player inputs.
|-
| <AimingType>
| flag
| Look them up over [[XML:StNA#Animation_types|HERE]]. The pool of valid TRAMs, and therefore TRASs (aiming screens a character can choose from) is built from the TRSC files registered in the ONCC.
:
|-
|valign="top"| <FromState>
|valign="top"| flag
| [[Image:chr_debug_characters_shows_interpolated_animations.jpg|thumb|400px|right|Primary <FromState> in <Lookup> uses about 8 interpolating frames by default. Use Shortcut's <FromState> to override this frame number.]]

Look them up over [[XML:StNA#Animation_states|HERE]].
: When FromState is set to None, some default behaviors are ignored and are replaced by Shortcuts.
: Shortcuts extend the number of states from which an animation can be played and under what conditions (replacing this atomic yes/no).
|-
| <ToState>
| flag
| Look them up over [[XML:StNA#Animation_states|HERE]].
|-
|valign="top"| <Varient>
|valign="top"| flag
|(misspelled because Oni misspells it) If unused, the tag will simply be "<Varient />", such as for non-combat animations. Otherwise it contains one of these values:
: Combat
: LeftPistol
: LeftRifle
: Panic
: RightPistol
: RightRifle
: Sprint
|-
| <FirstLevel>
| int16
|Number of first level in which move becomes available to the player ("0" to make it available from the start).
|-
|valign="top"| <Shortcuts>
|valign="top"| parent tag
|
Works as an '''alternative FromState''' collection.

Shortcuts are accepted if their <Shortcut><FromState> value differs from the "primary" <Lookup><FromState> value. In other words, if you want to make a '''Shortcut''' that uses the '''same FromState''' value then you have to set '''primary FromState''' value to '''None'''. By doing that, the hardcoded interpolation frame length of about 8 frames can be overridden.

In the following example, the new interpolation length is 0. This will require the animation to match perfectly with the previous one. For a smooth transition to the next animation, set a suitable value at <Interpolation><End>.

<Lookup>
...
<FromState>None</FromState>
...
<Shortcuts>
<Shortcut>
<FromState>Standing</FromState>
<Length>0</Length>
<ReplaceAtomic>no</ReplaceAtomic>
</Shortcut>
</Shortcuts>

[[Image:TRAM interpolation - standard case.jpg|thumb|400px|left|Scenario A: hardcoded interpolation of 8 frames. Scenario B: changeable interpolation frame number.]]
|-
| <Shortcut>
| parent tag
|
|-
| <FromState>
| flag
| Look them up over [[XML:StNA#Animation_types|HERE]].
|-
|valign="top"| <Length>
|valign="top"| int16
|Amount of interpolating frames. While interpolations of rotation are less noticeable, interpolations of different positions can cause drift (i.e. sliding).

This is especially observed for transitions from idle to movements and vice versa — basically any combination of animations with different accelerations at start and end. By default, animations without specified Shortcut interpolation give about 8 frames of interpolation. For moves starting or ending in idle, it's better not to use interpolation. Just give the start and end frames the same positions and rotation values as the idle. Interpolations should always be considered a ''last resort''.

This drift can be observed even in vanilla animations — most prominently in Konoko's comb_k. Konoko's left foot should be in a fixed position as the animation starts from from Konoko's idle pose. However, the interpolation is causing her left foot to drift noticeably to the right and a bit forward.

The reason this happens is because the interpolation "mixes" two animations. When one animation transitions into another via interpolation, part of the animation system continues playing the initial animation, and part of it is playing the follow-up animation, with all the rotations and positions getting linearly interpolated.
|-
|valign="top"| <ReplaceAtomic>
|valign="top"| flag
|
: yes
: no
|-
|valign="top"| <Flags>
|valign="top"| flag
|These are top-level flags on the whole animation. See the other <Flags> for flags on an attack part.
:RuntimeLoaded
::(This bit is not stored on disk; it is used at runtime to mark that the animation was loaded.)
:Invulnerable
::While playing this animation, the player is invulnerable to melee damage and also cannot be thrown, but can still take damage from particles and falls.
:BlockHigh
::While playing this animation, the player can block high or undefined-height attacks within some arc in front of him. The height of an attack is found under the <Attack> section. If you set this flag on an animation where the player character is spinning, then the character can still be kicked in the back or thrown.
:BlockLow
::Same as above, only it can block low or undefined-height attacks.
:Attack
::Unused by the engine.
:DropWeapon
::If the player is armed, he drops his weapon when this animation plays.
:InAir
::Unused by the engine.
:Atomic
::Unused by the engine. Only the Start and End frames of the Atomic field below matter.
:NoTurn
:::Player cannot turn while performing this animation.
:AttackForward
::Unused by the engine.
:AttackLeft
::Same as above.
:AttackRight
::Same as above.
:AttackBackward
::Same as above.
:Overlay
::Not a standalone animation; it just overwrites part of an already-playing one, e.g. the weapon-holstering animation.
:DontInterpolateVelocity
::Unknown, but maybe it has something to do with {x,y,z} velocities and the fact that directional jumps, for example, take information about their direction vector from the {x,z} velocity part of the TRAM (the vertical Y component is in the ONCC).
:ThrowSource
::Oni expects this flag on all throw source animations.
:::Throws work in animation pairs: whenever a throw source is played, the other character must perform the throw target animation. See throw(n) types:
::::TRAM <TargetType> from [[XML:StNA#Animation types|StNA]] (first used throw starts at #96).
:::Characters have only their own pool of animations available. And since enemy's TRAC might not contain the necessary animation the information must be provided by the throw source TRAC.
::: Since every throw animation must have a throw animation type the ThrowSource flag is actually redundant.
:ThrowTarget
::Animation can hurt anybody with its attack part, including teammates. The player can even hurt himself with the TRAM's damage part (whereas a player cannot hurt himself with his own animation's attack part). It also allows two attack parts to be executed instead of only one (maybe a bug? more than two will result in a crash).
:::If you set the first attack part to be able to deal damage from the 1st to the 100th frame of the TRAM, and the second attack part to deal damage within that range (e.g. from the 25th to the 41st frame), then the first attack part will deal damage from the 1st to the 100th frame (as usual), but even if it hits, that second attack part can hurt the enemy as well during frames 25–41. Note that the second attack part must be executed within the first attack part's active "window", otherwise it won't work.
:RealWorld
::Unused by the engine. It appears this flag was used during the authoring process to create a TRAM and an OBAN from one animation source. The OBAN is supposed to store pelvis rotations and positions, allowing a character to move over obstacles/gaps. The vast majority of TRAMs with this flag are used in cutscenes.
:DoAim
::Applies the aiming animation overlay (PIS/RIF) if the player has a weapon.
:DontAim
::An aiming overlay will not be applied.
:CanPickup
::Player can pick up an item during this animation if he intersects with one during his movement.
:Aim360
::Unused by the engine.
:DisableShield
::If the player has an active [[supershield]], this disables it (the flag is placed on four Mutant Muro attacks: his two supers, the claw-stuck-into-ground move and the sliding "[[wikt:kancho|kancho]]" maneuver; it is also hardcoded to be removed when the Zeus Thunderbolt attack is used).
:NoAIPickup
::AIs are not permitted to pick up items with this animation.
|-
| <Atomic>
| parent tag
| Animation cannot be interrupted by player between the Start and End frames.
|-
| <Start>
| int16
|
|-
| <End>
| int16
|
|-
| <Invulnerable>
| parent tag
| Character will not take melee damage and cannot be thrown between the Start and End frames.
|-
| <Start>
| int16
| First frame of character being invulnerable.
|-
| <End>
| int16
| Last frame of character being invulnerable.
|-
| <Overlay>
| parent tag
|
|-
|valign="top"| <UsedBones>
|valign="top"| flag
|Simply contains "<UsedBones />" if no bones are involved, otherwise:
:Pelvis
:LeftThigh
:LeftCalf
:LeftFoot
:RightThigh
:RightCalf
:RightFoot
:Mid
:Chest
:Neck
:Head
:LeftShoulder
:LeftArm
:LeftWrist
:LeftFist
:RightShoulder
:RightArm
:RightFist
|-
|valign="top"| <ReplacedBones>
|valign="top"| flag
| "<ReplacedBones />" if unused, otherwise:
:Pelvis
:LeftThigh
:LeftCalf
:LeftFoot
:RightThigh
:RightCalf
:RightFoot
:Mid
:Chest
:Neck
:Head
:LeftShoulder
:LeftArm
:LeftWrist
:LeftFist
:RightShoulder
:RightArm
:RightFist
|-
| <DirectAnimations>
| parent tag
|
|-
| <Link>
| link
| First slot. "<Link />" if unused.
|-
| <Link>
| link
| Second slot. "<Link />" if unused.
|-
| <Pause>
| parent tag
|
|-
| <Hard>
| int16
| In ticks. The Hard and Soft pause values are ignored if this animation has a direct link (above) to another animation.
|-
|valign="top"| <Soft>
|valign="top"| int16
| In ticks. As mentioned above, the player cannot enter new inputs during this pause unless this animation is part of a combo animation defined by <DirectAnimations><Link>.
: Examples:
: COMcomb_p, (no pause) COMcomb_p_p
: COMcomb_p, (pause) COMcomb_k

The difference between the hard and soft pause is that you can block during the soft pause and not the hard pause.
|-
| <Interpolation>
| parent tag
|
|-
|valign="top"| <End>
|valign="top"| int16
|
* interpolates first X frames of next animation
* if the first follow-up animation is too short, it can continue to play even further (not observed with vanilla anims)

While interpolations with rotations are less noticeable, interpolations of different positions can cause an additional drift.

This was especially observed for transitions of idle to movements and vice versa — basically any combination of animations with different accelerations at the start and end. By default, animations without a specified Shortcut interpolation get about 8 frames of interpolation. For moves starting or ending in idle, it's better not to use interpolation. Just give the start and end frames the same positions and rotation values as the idle. Interpolations should always be considered a ''last resort''.

[[Image:TRAM interpolations - end interpolation bigger than next anim.jpg|thumb|400px|left|"End" interpolation covering multiple follow-up animations.]]
|-
| <Max>
| int16
| unused
|-
|valign="top"| <FinalRotation>
|valign="top"| float
|valign="top"| Ending rotation in degrees. (During an animation on the player character, the camera is detached rotation-wise. If this value matches the body's final rotation, it will prevent a "glitchy" re-attaching.)
|-
|valign="top"| <Direction>
|valign="top"|
| Used by [[AI#Melee combat behaviors|AI melee system]].
:None
:Forward
:Backward
:Left
:Right
|-
| <Vocalization>
| int
| ID of one of the [[XML:SNDD#Step 1: Preparing the TRAM|SoundConstants in ONCC]]
|-
| <ActionFrame>
| int
| Frame number for any special events associated with this animation: weapon theft via disarm, weapon holstering, Mukade teleporting, items getting handed over to player, etc.
|-
| <Impact>
| link
| "<Impact />" if unused.
|-
|valign="top"| <Particles>
|valign="top"| parent tag
| serves as group element
|-
|valign="top"| <Particle>
|valign="top"| parent tag
| holds individual particle data
|-
|valign="top"| <Start>
|valign="top"| int
| frame number for particle to start
|-
|valign="top"| <End>
|valign="top"| int
| frame number for particle to end (if the number exceeds frame count of animation, the particle will simply die at the end of the animation)
|-
|valign="top"| <Bone>
|valign="top"| flag
|
: Pelvis
: LeftThigh
: LeftCalf
: LeftFoot
: RightThigh
: RightCalf
: RightFoot
: Mid
: Chest
: Neck
: Head
: LeftShoulder
: LeftArm
: LeftWrist
: LeftFist
: RightShoulder
: RightArm
: RightFist
|-
|valign="top"| <Name>
|valign="top"| link
| particle name in [[XML:ONCC#ONCP:_Oni_Character_Particle_.28Array.29|ONCC-ONCP]]
|-
| <MotionBlur>
| parent tag
|
|-
| <MotionBlur>
| parent tag
| sequence element
|-
|valign="top"| <Bones>
|valign="top"| flag
|
: Pelvis
: LeftThigh
: LeftCalf
: LeftFoot
: RightThigh
: RightCalf
: RightFoot
: Mid
: Chest
: Neck
: Head
: LeftShoulder
: LeftArm
: LeftWrist
: LeftFist
: RightShoulder
: RightArm
: RightFist
|-
| <Start>
| int16
| Start frame of motion blur sequence
|-
| <End>
| int16
| End frame of motion blur sequence
|-
| <Lifetime>
| int8
| Lifetime of each "ghost" in frames.
|-
| <Alpha>
| int8
| Transparency of "ghosts".
|-
| <Interval>
| int8
| Frame interval between each rendered "ghost".
|-
| <Footsteps>
| parent tag
|
|-
| <Footstep>
| parent tag
|
|-
| <Frame>
| int16
|
|-
|valign="top"| <Type>
|valign="top"| flag
|
: Left
: Right
|-
| <Sounds>
| parent tag
| "<Sounds />" if unused.
|-
| <Sound>
| parent tag
|
|-
| <Name>
| char[32]
| OSBDfile.imp.oni (don't use resource type's prefix or suffix)
|-
| <Start>
| int16
|The frame when the sound starts to play.
|-
| <Heights>
| parent tag
|
|-
| <Height>
| float
|Absolute position.
|-
| <Velocities>
| parent tag
|
|-
| <Velocity>
| 2 x float
|Relative positions (delta values); the numbers represent the change in position from one frame to another.
|-
| <Rotations>
| parent tag
|
|-
| <Bone>
| parent tag
|There are 19 bone tags, one for each [[TRIA#Bones|body part]].
|-
| <EKey>
| int8 + 3 * float
|For normal animations. The first value is the number of frames for which the rotation is maintained; the sum of all of these first EKey components always equals the total number of frames for the animation.
|-
|valign="top"| <QKey>
|valign="top"| int8 + 4 * float
|For overlay animations used by [[TRAS|TRAS]] aiming screens.

OniSplit v0.9.54.0 produces <QKey>s (quaternions) instead of <EKey>s (Euler rotations) for normal animations.
|-
| <PositionOffset>
| parent tag
| <PositionOffset> and <Positions> belong together. In the [[OBD:TRAM/raw0x30|binaries]], they are written in place. '''Seems unused; changing them has no effect in-game.'''
|-
| <X>
| int16
|
|-
| <Z>
| int16
|
|-
| <Positions>
| parent tag
|
|-
| <Position>
| float
| seems to be unused (and when checking this with "chr_debug_sphere = 1", the spheres remain unchanged)
|-
| <Height>
| float
| vertical extent
|-
| <YOffset>
| float
| Y offset of the vertical extent from character location
|-
| <ThrowSource>
| parent tag
| "<ThrowSource />" if unused.
|-
| <TargetAdjustment>
| parent tag
| Used to position targets during throws, relative to the position of the character executing the throw.
|-
|valign="top"| <Position>
|valign="top"| 3 * float
| Contains XYZ values, which position the target character at the start of the animation:
*X - Side axis. Negative values move the target to the right and positive values move the target to the left.
*Y - Height axis. Negative values move the target downwards, but cannot make the target go below the floor. Positive values make the target go upwards; this will lift the target's collision sphere off the ground as if they jumped. However if the value is too big, the target will teleport upward and then immediately start falling, interrupting the target animation.
*Z - Forward axis. Negative values move the target backwards and positive values move the target forward.
|-
| <Angle>
| float
| In radians - adjusts the rotation of the target in Oni's Y axis; most of the time (if not always) it's set to ''3.14159274'' radians in vanilla anims, equaling 180 degrees - which effectively rotates the rotates by those 180 degrees; if it was set to 0, the target would face the throw source character with his back.
|-
| <Distance>
| float
| Activation distance. The throw can be triggered if it is within this range. However the value must be greater than the equivalent TRAM in the parent TRAC or else the equivalent TRAM will play when the throw takes place outside of this TRAM's range and within that TRAM's range.
|-
|valign="top"| <TargetType>
|valign="top"| flag
| The flags are part of the [[XML:StNA#Animation_types|animation type list]].

(static throws)
: Thrown1 = ###COMthrow_fw_p_tgt
: Thrown2 = ###COMthrow_fw_k_tgt
: Thrown3 = ###COMthrow_bk_p_tgt
: Thrown4 = ###COMthrow_bk_k_tgt
(running throws)
: Thrown5 = ###COMrun_throw_fw_p_tgt
: Thrown6 = ###COMrun_throw_fw_p_tgt
: Thrown7 = ###COMrun_throw_bk_k_tgt
: Thrown8 = ###COMrun_throw_bk_k_tgt (not tested)
(tackle throw = catching)
: Thrown9 = ###COMrun_tkl_fw_p_tgt (not tested)
: Thrown10 = ###COMrun_tkl_bk_p_tgt
(pistol disarms)
: Thrown11 = ###PISthrow_fw_p_tgt
: Thrown12 = ###PISthrow_fw_k_tgt
: Thrown13 = ###PISthrow_bk_p_tgt
(rifle disarm)
: Thrown14 = ###PISthrow_bk_k_tgt (not tested)
: Thrown15 = ###RIFthrow_fw_p_tgt
: Thrown16 = ###RIFthrow_bk_p_tgt
: Thrown17 = ###RIF? = (not tested)
----
About the naming:
: "fw" = face-to-face throw
: "bk" = thrower is facing victim's back
: "throw" inside TRAM names is sometimes shortened to "thr"
: "p"/"k" = triggered by punch or kick button ("p" is sometimes omitted)
|-
| <SelfDamage>
| parent tag
|"<SelfDamage />" if unused.

Works only with specific, hardcoded AnimTypes (mainly ThrownX, it's unknown if any other types work - that remains to be investigated). Using SelfDamage on an AnimType that wasn't intended for it will cause the game to crash. (ToDo: Checked if <Flag>ThrowTarget is enough to explain this. Modify a simple kick? For more please link to and use talk page.)

From a practical standpoint, this means SelfDamage can be used only on ThrowTarget animations.
|-
| <Damage>
| parent tag
| sequence element
|-
| <Points>
| int16
| Damage taken by character.
|-
| <Frame>
| int16
| Frame of the animation when damage is dealt.
|-
| <Attacks>
| parent tag
|
|-
|valign="top"| <Attack>
|valign="top"| parent tag
| Only 2 attack parts per file are allowed. Normally the target gets only one hit. But if the attack frame ranges of both attack parts are overlapping, then the target can be hit by both of them.

Total frames: ==============================
Attack 1: ---##############-------------
Attack 2: ------------##############----

|-
| <Start>
| int16
| First frame where damage can be inflicted on an opponent.
|-
| <End>
| int16
| Last frame where damage can be inflicted on an opponent.
|-
| <Bones>
| flag
| The bones which can inflict damage.
|-
|valign="top"| <Flags>
|valign="top"| flag
|These are flags on an attack part, inside an <Attacks><Attack> element. See the previous <Flags> for general flags on the TRAM.
: Unblockable
: Low - Target of attack needs to crouch in order to block this attack.
: High - Blocker needs to stand; if both Low and High are set, blocker can block from both standing and crouching positions.
: HalfDamage - Blocker still receives half of the normal damage.
|-
| <Knockback>
| float
| Target gets knocked back by this amount if attack is successful.
|-
| <HitPoints>
| int16
| Damage points inflicted by attack.
|-
| <HitType>
| flag
| Animation type for opponent's animation when the attack isn't blocked. The flags are part of the [[XML:StNA#Animation types|animation type list]].
|-
| <HitLength>
| int16
| Number of frames that the target should remain in his hit animation state when he gets hit. If > 20, Oni automatically upgrades the character to a stagger animation, the length of which is the greater of 30 or <HitLength>.
|-
| <StunLength>
| int16
| Number of frames that the target should remain in his blocking animation state when he blocks the attack.
|-
| <StaggerLength>
| int16
| Number of frames that the target should perform his stagger animation after a successful block.
|-
| <Extents>
| parent tag
| Explained below. Automatically calculated by OniSplit if there's a DAE file referenced in the XML.
|-
| <Extent>
| parent tag
| One tag per attack frame. Number of <Extent> tags = <Attack><End> - <Attack><Start> + 1.
|-
| <Angle>
| float
| In degrees.
|-
| <Length>
| float
|
|-
| <MinY>
| float
|
|-
| <MaxY>
| float
|
|-
|valign="top"| <AttackRing>
|valign="top"| parent tag
| Always contains 36 <Length> tags, explained below. Automatically calculated by OniSplit if there's a DAE file referenced in the XML. (AttackRing was formerly known as "horizontal extents" in older versions of OniSplit.)
|-
|valign="top"| <Length>
|valign="top"| float
| Horizontal extents, explained below. They create a "danger zone" around the attacker which the AI uses to try to dodge an attack.
|}

==Export==
TRAM files can be extracted '''A) as pure XML''' files or '''B) as a pair of XML and DAE''' files. For editing the actual animation, you will want to use method B. While exporting an ONCC, you might see errors such as:

Cannot find instance 'TRAMKONCOMthrow_rev'
Cannot find instance 'TRAMKONCOMthrow_rev'
Cannot find instance 'TRAMKONRIFturn_right'
Cannot find instance 'TRAMKONOKOlev18_ZomStand'
Cannot find instance 'TRAMKONOKOcorner_hide'
Cannot find instance 'TRAMKONPIScorner_hide'

Ignore them, as those files doesn't exist. (Someday we should remove them from the TRACs.)

===Via command line===
To export a single TRAM:
onisplit -extract:xml output_path -anim-body:path_to\TRBS_or_ONCCname.oni path_to\TRAMname.oni

To export merged TRAMs:
onisplit -extract:xml output_path '''-anim-merge''' -anim-body:path_to\TRBS_or_ONCCname.oni path_to\TRAMname1.oni path_to\TRAMnameN.oni

===Via Vago===
[[Image:Vago_xml_plus_dae_extraction.png|thumb|200px|right|Combined extraction of DAE and XML.]]

Change to Characters tab and follow these steps.

'''Step 1:''' Select "TRAM ONI" as input format ("From").

'''Step 2:''' Select "XML / XML & DAE" as output format ("To").

'''Step 3:''' Tick checkbox "Extract with TRBS / ONCC". It's important this is done before adding a TRAM file.

'''Step 4:''' Set full path of ONCC or TRBS.

'''Step 5:''' Add TRAM file.

'''Step 6:''' Click "Convert".

===Via Simple OniSplit GUI===
There was a long-standing problem with combined ONCC/TRAM files where the textures would be missing.

'''[http://www.paradox.oni2.net/programs/Simple_OniSplit_GUI.zip Simple OniSplit GUI]''' post-edits the DAE to fix missing textures. The character-related .oni files must be all in one folder. Usually the level0_Final folder does the trick.

'''Step 1:''' Drag and drop the TRAM and ONCC into the [http://www.paradox.oni2.net/images/simpleOniSplitGui.png big field.] (One by one or simultaneously; the order doesn't matter.)

'''Step 2:''' Hit "Convert".

==Editing 3D data==
===Blender===
See the [[Blender]] article for a general tutorial on using the free program to create animations for Oni. It also contains a Blender addon for automating certain tasks, troubleshooting advice, and links to an animation rig that makes animation much easier.

===XSI===
In the past, the community's preferred tool for any 3D modeling and animation was {{ModTool}}. However, this free program was discontinued in 2014, and modders did not want to be tied to an aging (not to mention Windows-only) program. Thus, we have generally moved to using Blender (see next section). The following information is preserved for historical purposes.
----
For the correct Mod Tool settings, see [[Mod Tool#Animating|HERE]].

Here are some hints for creating animations when there is no rigging available:
* Use the ONCC model in your 3D editor that will actually make use of the animations. This makes sure that the pelvis height will match and that the character's feet will not float in the air or go through the ground.
* The first frame and last frames should match the probable previous and follow-up animations. This will reduce the necessity for long interpolations.
* When setting keyframes, each body part should have moved. This rule of thumb will give a more natural-looking animation.
* The first body part to be animated is always the pelvis.
* Watch out for pelvis rotations so that the XYZ rotations don't overlap too much, otherwise you will get into a [[wp:Gimbal lock|gimbal lock]].

Also see our OCF thread [http://web.archive.org/web/20220524164331/http://oni.bungie.org/forum/viewtopic.php?id=1433 "Creating new animations (TRAMS) for Oni"].

==Import==
onisplit -create output_path path_to\TRAMname.xml

==Common operations on animations by the community==
===Speeding up existing animations===
s10k has created an XmlTools script that allows the speed-up of any existing TRAM by removing frames. More information and download link [http://mods.oni2.net/node/354 here.]

==Selected notes on animation types==
===Attacks===
====Extents and XML====
'''As a regular modder you don't need to know how the attack ring and the extents get calculated.''' If you just want to create an attack animation then add an appropriate <Attacks> code block to your XML as seen under {{SectionLink||Using OniSplit to calculate extents}}.

'''How attack ring (horizontal extents) and extents get calculated'''

Ever wondered how the AI can recognize incoming attacks and block or dodge them? Extents (found by geyser and fully uncovered by Neo) are the key. Imagine the character looked at from above, and visualize a circle with this character being at the center of the circle. Now divide this circle into 10° segments, and those are the 36 units of horizontal extents (that is, the lateral reach of the attack). The 0° point is directly in front of the character and 180° is behind the character. The segments run clockwise around the character. So the first Extent tag is the horizontal reach on the 0° line, the second tag is for the line 10° clockwise, and so on. Note that a frontal attack like a simple kick could hit a target not only if he's standing at 0° (directly in front), but also at 10° or 20° to the right, and also at 340° and 350° (a bit to the left). When setting these manually, you should guess the inner and outer ranges of the reach of the attacker's bones that have damage attached to them. Test these values with an AI that blocks often. If you did it right, your attack will often be blocked, but if the extent length is too high, the AIs will react when too far from you, which does not look good.

There are two types of extents:
*'''<Extents>''' stores this info:
::<Angle> at which this extent radiates from the character.
::<Length> of this extent.
::<MinY> minimum height of this extent.
::<MaxY> maximum height of this extent.
:Length, MinY and MaxY serve to create an invisible area in space which is "dangerous to be in". If an AI intersects with this area and notices it (refer to the Notice field in [[MELE]]), it will attempt to block or dodge according to its modifiers in its MELE profile.
::The number of <Extent>s is equal to the number of attack frames: <End> minus <Start> plus one (because the start frame counts too). For example, for TRAMKONCOMkick_low1: <End>30</End> minus <Start>22</Start> plus 1 = 9 <Extent>s.

*'''<AttackRing> (formerly known as <HorizontalExtents>''' stores this info:
::36 fields (exactly 36, otherwise it won't compile back into a .oni file), which correspond to areas in 10° intervals around the character as described above.

====Using OniSplit to calculate extents====
Let's say that you want to convert a non-attack animation to a damage-dealing animation. Non-attack TRAMs do not have extents information used to notify the AIs about incoming attacks, so how do you generate this information from the animation?
:1. Export the animation to XML with a body attached. If you extract using just "-extract:xml dest_folder TRAMsomething.oni", you'll get the 3D animation data inside the XML (namely, the tags Heights, Velocities, Rotations, PositionOffset, and Positions; for an attack animation, you'll also get Attacks and AttackRing, and inside Attacks' elements, each Attack element will have Extents at the end of it).
:However, if you extract this same animation using "-extract:xml dest_folder TRAMsomething.oni '''-anim-body ONCCtramuser.oni'''", the animation data will be placed in a DAE file along with the character model geometry. Be sure to pick a body with a size that's representative of the character classes that will actually use this TRAM, because the extents will be calculated from it. The XML file will be very short without the 3D data in it — this is how we want the non-attack TRAM to look. We do not know the extents information that should go in Extents or AttackRing, so we just want to add the part that distinguishes a DAE-extracted attack TRAM XML from a DAE-extracted non-attack TRAM XML. That part is the Attacks section, without the Extents under each Attack.
:2. First, consider whether the TRAM should have something added to its Flags section, like Attack or ThrowTarget.
:3. Now add to the XML of the non-attack TRAM data in the following format (after the <SelfDamage /> section, typically):
<Attacks>
<Attack>
<Start>1</Start>
<End>10</End>
<Bones>RightWrist RightFist</Bones>
<Flags />
<Knockback>4</Knockback>
<HitPoints>10</HitPoints>
<HitType>KnockdownHead</HitType>
<HitLength>5</HitLength>
<StunLength>8</StunLength>
<StaggerLength>0</StaggerLength>
</Attack>
</Attacks>
:Do not add an AttackRing section after Attacks.
:4. Import this with "-create dest_folder TRAMsomething.xml". The Extents sections and the AttackRing will be calculated by OniSplit from the attached DAE.
:5. If you need this information for a patch mod, run "-extract:xml" on the TRAMsomething.oni you've created without using "-anim-body". Now you can copy the Extents and AttackRing data to your XML patch. For an example of how the patch should look, see the [http://mods.oni2.net/node/311 Domino Knockdowns] mod.

===Combos===
The type and order of player input for triggering a given animation type (such as PPK) is hardcoded, and new animation types cannot be created. That being said, Oni has unused combo animation types, such as PKP, PKK, KPK, KPP, etc. that work perfectly fine and can be used to create new combos. To assign an animation type to a specific combo attack, you set a corresponding value in <Lookup><Type>.

Setting a value in the <Link> of '''<DirectAnimations>''' will do two things:
# It will increase the time window for player input, meaning the next animation can be executed more easily. (In vanilla Oni, the Crescent Moon Kick has no link in KONCOMcomb_k_k_kfw and therefore is difficult to use.)
# It disables <Interpolation><End> for the next combo anim.
# It enables <Pause><Soft> and <Pause><Hard>.

===Just Frame input===
Implemented by Delano762, inspired by the game series Tekken, a Just Frame ("JF") move means that you have to press certain keys (W+K or W+P) at the exact same time, which is more difficult than it might sound. Delano's mod [http://mods.oni2.net/node/353 54000 New Combat Moves for Konoko] has a collection of animations which utilize existing animation states differently to create new moves.

Example 1:
* new forward kick = TRAMKONCOMkick_fw_JF <FromState>Standing
** key strokes: w + k
* old forward kick = TRAMKONCOMkick_fw <FromState>RunStart
** key strokes: w, k

Example 2:
* new forward punch = TRAMKONCOMpunch_fw_JF <FromState>Standing
** key strokes: w + p
* old forward punch = TRAMKONCOMpunch_fw <FromState>RunStart
** key strokes: w, p

Note that these animations are referred to as JF moves, not JF combos. The Crescent Moon Kick, as mentioned above, is an unintentional JF combo found in vanilla Oni.

===Throws===
;States
The first anim state of source (src) and target (tgt) is the "primary" <FromState>. The others <FromState> entries are located in <Shortcut>.

;Types
Throw target animations are registered in the TRAC of the throw initiator (AKA the throw source). Target animations are forced onto the other character. Throw target (TRAM*tgt) animations can only cover up to 256 frames (0-255).

The game identifies which Target animation is it supposed to play through the ''ThrownX'' animation types. Each throw, together with its corresponding Target animation, uses one of the 17 available ''ThrownX'' animation types. These types are used in three tags:

* <TargetType> tag in the Source animation,
* <Type> and <AimingType> tags in the Target animation.

For example, Konoko's forward punch throw / ''KONCOMthrow_fw_p'' uses Thrown1 as its TargetType tag:

<TargetType>Thrown1</TargetType>

And the corresponding target animation, ''KONCOMthrow_fw_p'', uses Thrown1 in the Type and AimingType tags:

<Type>Thrown1</Type>
<AimingType>Thrown1</AimingType>

The ''ThrownX'' anim types work like slots - if you want to add a new throw to the game, you have to assign both the Source and the Target animations the same ThrownX type in the tags listed above. While these "pairs" are organized within vanilla animations according to the Throw Table below, this is nothing more than a convention, and as a result ''ThrownX'' types can be used freely. To give an example, while all Forward Punch Throws in the game seem to use the Thrown1 type, you can swap those types with another throw and they will work just as fine.

The fact that the game has only 17 ''ThrownX'' types is a major limitation - this effectively means that each character can have no more than 17 throws - out of which only 4 are unused by any character in the game. This prevents modders from creating a significant number of throws despite the game allowing great flexibility in creating new throws by mixing Animation States, Animation Types and <Varient> tags.

{{divhide|Throw table for vanilla Oni}}
{| class="wikitable" width=100%
|-
! rowspan=2 width=240 | names
! rowspan=2 width=40 | key combo
! colspan=4 | context
! colspan=2 style="background: #FF0;" | anim type
! rowspan=2 width=400 | image
|-

! width=40 | varient
! width=60 | src state
! width=60 | tgt state
! width=85 | facing setup



! width=40 style="background: #FF0;" | src
! width=40 style="background: #FF0;" | tgt
|-
! colspan=9 | normal throws a.k.a. static throws
|- style="vertical-align:top;"
| static throw forward punch
: TRAMKONCOMthrow_fw_p
: TRAMKONCOMthrow_fw_p_tgt
| P + ↑
| COM
| '''Standing'''

RunStart
| '''Standing'''

Crouch 
Stunned
| face-to-'''face'''
| '''ThrowForwardPunch'''
| '''Thrown1'''
| [[Image:KONCOMthrow_fw_p.jpg|200px]]
|-style="vertical-align:top;"
| static throw forward kick
: TRAMKONCOMthrow_fw_k
: TRAMKONCOMthrow_fw_k_tgt
| K + ↑
| COM
| '''Standing'''

RunStart
| '''Standing'''

Crouch 
Stunned
| face-to-'''face'''
| '''ThrowForwardKick'''
| '''Thrown2'''
| [[Image:KONCOMthrow_fw_k.jpg|200px]]
|-style="vertical-align:top;"
| static throw backward punch
: TRAMKONCOMthrow_bk
: TRAMKONCOMthrow_bk_tgt
| P + ↑
| COM
| '''Standing'''

RunStart
| '''Standing'''

Crouch 
WalkingLeftDown 
WalkingRightDown 
Stunned
| face-to-'''back'''
| '''ThrowBackwardPunch'''
| '''Thrown3'''
| [[Image:KONCOMthrow_bk.jpg|200px]]
|-style="vertical-align:top;"
| static throw backward punch
: TRAMKONCOMthrow_bk_k
: TRAMKONCOMthrow_bk_k_tgt
| K + ↑
| COM
| '''Standing'''

RunStart
| '''Standing'''

Crouch 
WalkingLeftDown 
WalkingRightDown 
Stunned
| face-to-'''back'''
| '''ThrowBackwardKick'''
| '''Thrown4'''
| [[Image:KONCOMthrow_bk_k.jpg|200px]]
|-style="vertical-align:top;"
! colspan=9 | run throws
|-style="vertical-align:top;"
| run throw forward punch
: (forward "lariat")
: TRAMKONCOMrun_throw_fw
: TRAMKONCOMrun_throw_fw_tgt
| P + ↑(↑)
| COM
| '''None'''

RunningLeftDown 
RunningRightDown
| '''Standing'''

RunningLeftDown 
RunningRightDown 
Stunned 
WalkingLeftDown 
WalkingRightDown 
| face-to-'''face'''
| '''RunThrowForwardPunch'''
| '''Thrown5'''
| [[Image:KONCOMrun_throw_fw.jpg|200px]]
|-style="vertical-align:top;"
| run throw forward kick
: TRAMKONCOMrun_thw_fw_k
: TRAMKONCOMrun_thw_fw_k_tgt
| K + ↑(↑)
| COM
|'''None'''

RunningLeftDown 
RunningRightDown
|'''Standing'''

RunningLeftDown 
RunningRightDown 
Stunned 
WalkingLeftDown 
WalkingRightDown
| face-to-'''face'''
| '''RunThrowForwardKick'''
| '''Thrown6'''
| [[Image:KONCOMrun_thw_fw_k.jpg|200px]]

|-style="vertical-align:top;"
| run throw backward punch
: (backward "lariat")
: TRAMKONCOMrun_throw_bk
: TRAMKONCOMrun_throw_bk_tgt
| P + ↑(↑)
| COM
|'''None'''

RunningLeftDown 
RunningRightDown
|'''Standing'''

RunningBackLeftDown 
RunningBackRightDown 
WalkingRightDown 
WalkingLeftDown 
Stunned

| face-to-'''back'''
| '''RunThrowBackwardPunch'''
| '''Thrown7'''
|
|-style="vertical-align:top;"
| run throw backward kick
: TRAMREDCOMrun_thw_bk_k
: TRAMREDCOMrun_thw_bk_k_tgt
| K + ↑(↑)
| COM
|'''None'''

RunningLeftDown 
RunningRightDown
|'''Standing'''

RunningBackLeftDown 
RunningBackRightDown 
Stunned
| face-to-'''back'''
| '''RunThrowBackwardKick'''
| '''Thrown8'''
| [[Image:REDCOMrun_thw_bk_k.jpg|200px]]
|-style="vertical-align:top;"
! colspan=9 | catching throws a.k.a. tackle throws
|-style="vertical-align:top;"
| tackle throw backward kick? (never used)
|
|
|
|
|
|
| Thrown9
|
|-style="vertical-align:top;"
| tackle throw backward punch
: TRAMKONCOMrun_tkl_bk_p
: TRAMKONCOMrun_tkl_bk_p_tgt
| P + ↑(↑)
| COM
|'''None'''

RunningLeftDown 
RunningRightDown
|'''None'''

RunningLeftDown 
RunningRightDown
| face-to-'''back'''
| '''RunThrowBackwardPunch'''
| '''Thrown10'''
| [[Image:KONCOMrun_tkl_bk_p.jpg|200px]]
|-style="vertical-align:top;"
! colspan=9 | disarm throws
|-style="vertical-align:top;"
| pistol disarm throw forward punch
: TRAMKONPISthrow_fw_p
: TRAMKONPISthrow_fw_p_tgt
| P + ↑
| PIS
|'''Standing'''

RunStart
|'''Standing'''

Crouch 
Stunned
| face-to-'''face'''
| '''ThrowForwardPunch'''
| '''Thrown11'''
| [[Image:KONPISthrow_fw_p.jpg|200px]]
|-style="vertical-align:top;"
| pistol disarm throw forward kick
: TRAMKONPISthrow_fw_k
: TRAMKONPISthrow_fw_k_tgt
| K + ↑
| PIS
|'''Standing'''

RunStart
|'''Standing'''

Crouch 
Stunned
| face-to-'''face'''
| '''ThrowForwardKick'''
| '''Thrown12'''
| [[Image:KONPISthrow_fw_k.jpg|200px]]
|-style="vertical-align:top;"
| pistol disarm throw backward punch
: TRAMKONPISthrow_bk
: TRAMKONPISthrow_bk_tgt
| P + ↑
| PIS
|'''Standing'''

RunStart
|'''Standing'''

Crouch 
WalkingLeftDown 
WalkingRightDown 
Stunned
| face-to-'''back'''
| '''ThrowBackwardPunch'''
| '''Thrown13'''
| [[Image:KONPISthrow_bk.jpg|200px]]
|-style="vertical-align:top;"
| (never used)
|
|
|
|
|
|
| Thrown14
|
|-style="vertical-align:top;"
| rifle disarm throw forward punch
: TRAMKONRIFthrow_fw_p
: TRAMKONRIFthrow_fw_p_tgt
| P + ↑
| RIF
|'''Standing'''

RunStart
|'''Standing'''

Crouch 
Stunned
| face-to-'''face'''
| '''ThrowForwardPunch'''
| '''Thrown15'''
| [[Image:KONRIFthrow_fw_p.jpg|200px]]
|-style="vertical-align:top;"
| rifle disarm throw backward punch
: TRAMKONRIFthrow_bk_p
: TRAMKONRIFthrow_bk_p_tgt
| P + ↑
| RIF
|'''Standing'''

RunStart
|'''Standing'''

Crouch 
Stunned
| face-to-'''back'''
| '''ThrowBackwardPunch'''
| '''Thrown16'''
| [[Image:KONRIFthrow_bk_p.jpg|200px]]
|-style="vertical-align:top;"
| (never used)
|
|
|
|
|
|
| Thrown17
|
|}
{{divhide|end}}

;Running disarms
Oni offers support for running disarms (originally noticed [[OBD:BINA/OBJC/MELE/MoveList/Throw|HERE]]), which was taken advantage of by Delano's mod [http://mods.oni2.net/node/353 54000 New Combat Moves for Konoko].

;Forward throws
Scenario: You load two characters into Mod Tool and rotate (+/-180°) the throw target character because you need them to stand face to face as you work on an animation. When you are done animating, the target animation would need to be reversed again. This means multiplying the velocities by -1; the rotation also needs correcting. So it looks like you need *(-1) for the x rotation and -/+180° (depending on your initial change) for the Y rotation.

There is a Blender script implemented within the BlenderOni addon for rotating and adding PositionOffset to a forward throw Target animation. It is capable of adjusting both forward and back throws. The script's old version can be accessed [[Blender/Obsolete scripts#Script for adjusting forward throw targets|HERE]].

===Run animations===
Here's a breakdown of the Striker's run animations, meant as an illustration for what would be needed to make new run TRAMs.

Run cancel:
* STRIKEidle1 / another idle animation
* STRIKErun1stepa
* STRIKErun1stepb
* STRIKEidle1 / another idle animation

Run – ''a minimal cycle'':
* STRIKEidle1 / another idle animation
* STRIKErun1stepa
* STRIKErunstart
* STRIKErun_rt
* STRIKErun_lt (optional)
* STRIKErunstop
* STRIKEidle1 / another idle animation

Follow the images below from right to left.
<gallery>
Image:XML_TRAM_STRIKErunstop.png|STRIKErunstop
Image:XML_TRAM_STRIKErun_lt.png|STRIKErun_lt
Image:XML_TRAM_STRIKErun_rt.png|STRIKErun_rt
Image:XML_TRAM_STRIKErunstart.png|STRIKErunstart
Image:XML_TRAM_STRIKErun1stepa.png|STRIKErun1stepa
</gallery>

==List of unused animations==
Here are all the known unused animations, with links to videos of them where applicable. These could be recycled in a new mod.

'''From the original game'''
* KONOKOconsole_punch: What the name says (the engine can use that animation depending on the console's configuration, see [[OBD:BINA/OBJC/CONS|CONS]]) .
* KONOKOlev3_intro: Looks like she's placing something (bomb?) and then running away.
* [https://www.youtube.com/watch?v=dszw2vmlmzw KONOKOlev4_undress]: From an aborted clothes-changing cutscene.
* KONOKOlev16_bomb: Planting a bomb.
* KONCOMsuper_kick: Now used in [[OTA]] as a spawn event, and by the fan-made character [[Shinatama Evolved]].
* KONCOMsuper_punch: KONCOMpunch_heavy but without the shouted attack name, has HalfDamage flag, and does 10 less damage in its first attack part.
* [https://www.youtube.com/watch?v=CRuZq_uYOQk COMPISidle_special1]: Comguy checking environment and his gun; meant for a feature that would visually depict an elevation in the AI's level of alertness after, say, hearing a noise.
* STRPISidle_special1 (see above link): Striker checking his his gun and communicating with an ally (another unused alertness-elevation animation).
* THUGlev1_direct: Thug probably directing a truck driver.

'''From modders'''

[[Image:Female stun.jpg|right|thumb|Char A and Char B performing stun animations.]]

* http://mods.oni2.net/node/376
** StrikerKneeStepKickThrow.zip
** REDCOMjump_fw_crouch--double_flip--dae.zip
** KONprone_getup--dae.zip
** KONRIF_k_bk_throw.zip
** female_stun--dae.zip

==Special effects==
If the scene is overloaded by too many particles (including motion blur), these effects will cease being rendered. So don't overuse effects.

===Color trails===
Open the XML-accompanied TRAM, search for the "Particles" tag, and insert your markup.

First example: TRAMSTRCOMcomb_p_p.xml

[[Image:Colorful_contrail_added.png|right|thumb]]

<Particles>
<Particle>
<StartFrame>0</StartFrame>
<EndFrame>12</EndFrame>
<Bone>LeftFist</Bone>
<Name>contrail</Name>
</Particle>
</Particles>

"contrail" is looked up by the character class (ONCC) that emits the actual particle; here it is "h2h_strtrail_e01".

This second example is about creating two different contrails in a TRAM at the same time. The animation is "TRAMSTRCOMpunch_heavy.xml".

[[Image:Different_contrails_in_attack.png|right|thumb]]

<Particles>
<Particle>
<Start>0</Start>
<End>54</End>
<Bone>RightWrist</Bone>
<Name>contrail</Name>
</Particle>
<Particle>
<Start>0</Start>
<End>54</End>
<Bone>LeftWrist</Bone>
<Name>'''contrail_2'''</Name>
</Particle>
</Particles>

Note that you need to register the second contrail in the ONCC as well. Using your own contrail particle is also possible; just insert its name between the <Type> tags.

<ONCPParticle>
<Name>contrail</Name>
<Type>h2h_strtrail_e01</Type>
<BodyPart>-1</BodyPart>
</ONCPParticle>
<ONCPParticle>
<Name>'''contrail_2'''</Name>
<Type>'''h2h_murtrail_e01'''</Type>
<BodyPart>-1</BodyPart>
</ONCPParticle>

===Motion blur===
[[Image:XML_TRAM_willow_kick_with_motion_blur.jpg|thumb|200px]]
Motion blur in Oni works much like ghosting/onion skinning features in any animation software: In the frame range specified by <Start> and <End> an additional instance of body parts specified in <Bones> are rendered for additional extra frames specified by <Lifetime>, with transparency set by <Alpha>, and every <Interval> frames within the frame range.
Example snippet from KONCOMcomb_p_p_k:
<MotionBlur>
<MotionBlur>
<Bones>RightThigh RightCalf RightFoot</Bones>
<Start>20</Start>
<End>28</End>
<Lifetime>4</Lifetime>
<Alpha>127</Alpha>
<Interval>1</Interval>
</MotionBlur>
</MotionBlur>

The one noteworthy thing is that you can have multiple motion blur sequences. If you wanted to add an extra motion blur to the above animation, you could do something like this:
<MotionBlur>
<MotionBlur>
<Bones>LeftThigh LeftCalf LeftFoot</Bones>
<Start>10</Start>
<End>18</End>
<Lifetime>4</Lifetime>
<Alpha>127</Alpha>
<Interval>1</Interval>
</MotionBlur>
<MotionBlur>
<Bones>RightThigh RightCalf RightFoot</Bones>
<Start>20</Start>
<End>28</End>
<Lifetime>4</Lifetime>
<Alpha>127</Alpha>
<Interval>1</Interval>
</MotionBlur>
</MotionBlur>

===Impact effect===
Impact effects – mostly particle – are chosen based on logic written within [[XML:BINA/ONIE#Visual guides: weapon, melee, environment|ONIE]]. Furthermore particles must be registered in [[XML:ONCC|ONCC]]: You probably want to look at ONIA instead of ONCP.

[[Image:XML_TRAM_KONCOMkick_fw_with_ninflash1.jpg|thumb|200px]]

{{XML}}

Zukai

2025-12-26T06:07:47Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{fmbox
| text = This project is currently only in development for Macs, until it is more polished.
}}

{|style="float:right;" border=1 cellspacing=0
|[[Image:Zukai logo.png|center]]
{|cellspacing=3
!colspan="2"|Zukai Multiplayer
|-
|'''Developer:'''
|align="right" |[[User:Iritscen|Iritscen]]
|-
|colspan="2" align="center"|'''Currently at''' {{/Change log}}
|-
|align="left"|[[/Change log|Change log]]
|align="right"|[https://bugs.oni2.net/query?component=Zukai&order=priority&report=11 Bug reporting]
|-
|colspan="2" align="center"|[http://web.archive.org/web/20171120015337/http://oni.bungie.org/forum/viewtopic.php?id=2841 Forum thread]
|}
|}

'''Zukai''' is the most recent attempt at [[multiplayer]] for [[Oni]]. Zukai is in an alpha-like stage of development for macOS until it reaches v0.1, at which point it will be ported to Windows, and development will continue on both platforms. It currently comes in the form of a bundle called '''Daodan.plugin''' and an Oni [[AE:Plugins|level plugin]] called '''level0_Zukai''' with supplemental resources.

''Zukai'' is a Japanese word connected to the ancient art of puppetry and puppet theater (''[[wikipedia:Bunraku|bunraku]]''). Its usage in this project is based on the expression ''Ningyō Zukai'' ("Puppet Master") in [[Ghost in the Shell]], though translations of the word ''zukai'' alone range from "messenger" to "operator" to "familiar spirit" to "trainer". The icon for the project is based on the ''kanji'' for another word for puppetry, ''ayatsuri'' (操り).

{{TOClimit}}

==Download==
See the [http://web.archive.org/web/20171120015337/http://oni.bungie.org/forum/viewtopic.php?id=2841 official release forum thread] for download links.

==Installation==
:Note: You must start with a vanilla Oni installation. Zukai does not yet support mods or the Anniversary Edition.
# Disable the scripting for the level you want to play in. A simple way to do this for all levels is to rename the [[IGMD]] folder to "~IGMD".
# Make sure that you have version 1.2 (or later) of the Oni game app (see forum thread for download link).
# Place Daodan.plugin in the Oni installation folder at the same level as the game app.
# Place the level0_Zukai.dat/raw/sep files in [[GameDataFolder]].
# Add the line "bind m to mp_menu" to key_config.txt, or use whatever key is more convenient for you than 'm'. Create another binding for "mp_score" to be able to display the scoreboard during a match. Additional optional bindings are listed below.

==Playing==
[[Image:Zukai-Main Menu.jpg|thumb|350px|right|Look for the Zukai icon in the bottom-left before proceeding.]]
[[Image:Zukai-MP Menu.jpg|thumb|350px|right|Use the arrow keys to navigate the menu.]]
<div style="overflow:hidden">
#Decide what level you are going to play. Obtain the IP address of the player that will be hosting. If you get tired of dealing with IP addresses, players can sign up for a [https://www.noip.com/ No-IP] domain and provide that URL to players instead, e.g. joe-oni-fan.ddns.net.
#Launch Oni. Look for the Zukai icon on the Main Menu (pictured, left) to make sure that the plugin is active.
#Choose "Load Game" and load the level you are going to play (you can double-click the title or any save point, since scripting is disabled).
#Press your mp_menu key to bring up the Multiplayer Menu (pictured, right).
#Just follow the menus. The option "Join Iritscen's game" will not work unless I have let you know that I am hosting a game. If you are joining a game, and the other player has registered a No-IP domain or has some other URL which leads to his computer, you can type this into the "Host IP address/URL" field instead of an IP address. Also note that you can copy text from another window such as your chat client and paste it into the address field in the Multiplayer Menu.
#Because multiplayer cannot be paused, you are not allowed to access the Main Menu while playing Zukai. To quit playing, bring up the Multiplayer Menu and choose "Exit game", or double-tap the Escape key (if the host quits, this will end the match for everyone).
</div>
===Hosting tips===
*If you want to be able to host games, and not just join other people's games, make sure that you have forwarded port 2680 (UDP) to your computer's LAN (private) IP address in your router's settings. See this [https://portforward.com/router.htm port forwarding guide] for help.
*Until there is metaserver support (i.e., a matchmaking lobby), you will need to arrange matches with other players using a third-party program like an instant messenger or a chat room (e.g. {{Discord|nice=yes}}).
*Some hosts are plagued by the macOS dialog that says "Do you want the application 'Oni' to accept incoming network connections?" each time someone tries to join their game. To turn this off, you should add this Oni application to your Firewall exceptions (System Preferences > Security & Privacy > Firewall > Firewall Options... > '+' button). Sometimes this will not work, in which case you need to open Terminal and use this command, remembering to supply the correct path to your Oni application (your administrator password will be requested):
sudo codesign --force --deep --verbose --continue --file-list - --sign - /path/to/Oni.app/
:This performs ad-hoc code-signing, which takes the place of an official developer certificate. If successful, you will see output like this:
/Applications/Oni/Oni.app: signed bundle with Mach-O thin (i386) [com.godgames.oni]
/Applications/Oni/Oni.app/Contents/MacOS/Oni
/Applications/Oni/Oni.app/Contents/_CodeSignature/CodeResources

If it does not work, try the command several more times; it often doesn't seem to work on the first try. However, even if the signing is successful, you still have to tell macOS that the app is allowed to accept incoming connections, which means that you will get the dialog again the next time that you host. Once you click that "Allow" button one more time, macOS should remember that this "signed" copy of Oni can accept connections.

==Useful websites and programs==
*You might want to make use of [https://whatsmyip.net/ What's My IP] to get your Internet IP address (there are plenty of other websites that do this too).
*[https://www.noip.com/ No-IP.com] can be used to set up a domain for someone who wants to host frequently, allowing the easier exchange of host addresses with joiners than giving out the host's IP address.
*If the performance of an Internet game seems poor, look at the ping between you and other players. Zukai displays ping on the scoreboard when you press the mp_score button (see "Bindable actions" section), but if you want more rigorous measurement of the connection between yourself and another player, bring up Spotlight in macOS and start typing "Network Utility". When the Utility appears, open it and use the Ping tab to test the connection between you and them. The most important numbers in the final statistics, once pinging is done, are the packet loss, which should be 0-1%, the average ping ("round-trip avg", the third-to-last number), and jitter ("stddev", the last number), which should be less than 25% of the average ping.
*To record video footage of a match, see [[Capturing game footage]]. The recommended free method is using either OBS Studio or QuickTime Player for video, and capturing the game audio with either Soundflower or iShowU Audio Capture. The recommended commercial programs are ScreenFlow and iShowU, which capture both audio and video.

==Known bugs and limitations==
At the moment, Zukai is still rough, but the following problem areas will be the main focus of future updates until they are all corrected.
*You can only play as Konoko.
*No text chat.
*No proper matches or modes yet. All players can run around and attack each other, but there is no time limit or kill limit.
*No respawning or "intelligent" spawn points. Until respawning is introduced, players will not die. All players spawn around the host, who spawns at whatever Bungie West set as the default spawn point for Konoko. Because there is no death, the closest thing to a score is the total damage done, displayed with the mp_score button (see "Bindable actions" section), but this number is not synchronized between players yet, so each player will probably see a higher score for himself than what others will see for him.
*Weapons and some other things are not synchronized yet, and may cause gameplay to go out-of-sync (oos). You will have to start a new match to correct this.
*IPv6 is not supported yet, so if you have a v6-only IP address, you can't play. Please let me know if this affects you.
*Gameplay is currently very vulnerable to packet loss when a new player is joining; sometimes the match will "hang" because of this. To reduce packet loss, use a wired connection to your router/modem, not wireless. Packet loss resilience will come in an update fairly soon.
*Sometimes the wrong map name (level name) is given on the scoreboard.

==Bindable actions==
In addition to the [[Customizing/Binding|standard actions]] that you have always been able to bind using '''key_config.txt''', here is a list of actions added by the Zukai plugin for use in multiplayer mode.

===All players===
Both hosts and clients can use these actions:

;mp_menu
:This brings up the Multiplayer Menu when you are in-game, allowing you to host, join, or exit a game.

;mp_score
:Holding this key down displays the scoreboard, along with match time and player ping.

;mp_chat
:Coming soon!

;mp_graph_toggle, mp_graph_cycle
:To turn on, and cycle through, graphs that display information about the state of the multiplayer game. The network graph shows the size of incoming and outgoing traffic, and the timing graph shows how much time the multiplayer code is taking to execute in each frame.

===Hosts only===
These actions may only be available during this early phase of Zukai's development. They allow the host to change network settings for all players during a match, in order to see how performance is affected. You probably will want to talk to me before using them, but here they are:

;latency_toggle, latency_up, latency_down
:To turn on and adjust simulated latency. This feature is intended for use in matches with negligible real latency, e.g., LAN/loopback games, to reproduce the feel of an Internet game. If used in an Internet game, this will add additional latency on top of whatever natural latency already exists.

;jitter_toggle, jitter_up, jitter_down
:Simulated jitter (variation in latency) is automatically turned on when simulated latency is turned on, but you can use these actions to turn it off (to get flat simulated latency) or to alter the amount of jitter.

;pkt_rate_up, pkt_rate_down
:You can send gameplay data more or less frequently using these keys. The rate is measured as a delay in ticks, so raising the rate leads to sending data less frequently.

;state_rate_up, state_rate_down
:State events are communications between the client and the host which determine a client's correct position. As above, higher numbers mean less frequent events.

;pos_tol_up, pos_tol_down
:Not currently used. The "position tolerance" is how many world units a client's position can differ between his avatar on the host and his avatar on his own machine before his position is corrected. Higher numbers will mean that games are permitted to go further out of sync. Lower numbers will cause more frequent adjustments in position for clients. A world unit is four inches, so a position tolerance of 3 means "one foot".

;sync_now
:This is for developer use and does not have any effect in the MP builds which I am distributing.

==Settings==
When Zukai first runs, it creates a blank '''zukai_settings.txt''' file in the same folder. You can change certain settings from their defaults by assigning values to them with this syntax:

lock_these_settings:yes

Here are the settings currently supported:

{| class="wikitable"
!Setting name
!Values
!Default
!Description
|-
|lock_these_settings
|yes/no
|no
|No effect. Planned for use with an upcoming feature.
|-
|log_all_cli_output
|yes/no
|no
|For diagnosing issues with automatic log uploading; turning this on will dump messages from the upload process into the system log (Console.app).
|-
|log_everything_for
|...
|...
|Turns on extra logging detail. Only intended for use by the developer.
|-
|offer_loopback_network_type
|yes/no
|no
|Offer the choice of "Loopback" on the "Network type selection" screen. Allows testing of MP on a single machine by running multiple copies of Oni.
|-
|send_log_after_match
|yes/no
|yes
|You can turn off the automatic log upload that occurs after a match, but please don't do that unless it is causing issues.
|}

[[Category:Modding projects]]

Mod Tool/OniTools addon

2025-12-26T06:07:16Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

OniTools was a level creation addon for {{ModTool}}. It is no longer developed or maintained. Nowadays, modders are expected to use [[Blender]] rather than XSI.

===Download and installation===
Install by dragging and dropping '''[http://mods.oni2.net/node/356 OniTools.xsiaddon]''' into Mod Tool's viewport.

[http://oni.bungie.org/forum/viewtopic.php?id=2657 OCF thread]

<gallery>
Image:xsi_addon_weapon_manager.jpg|weapon manager
Image:xsi_addon_powerups_manager.jpg|powerups manager
Image:xsi_addon_flag_manager.jpg| flag manager
Image:xsi_addon_trigger_volume_manager.jpg|trigger volume manager
</gallery>

===Tips===
* while in point (vertex) mode, creating a flag/powerup/TV/weapon will move it to the selected point
* while in object mode, creating a flag/powerup/TV/weapon will spawn it at 0, 0, 0
** check the ''point snap'' checkbox, then use move tool [V] with [Control] to move object to desired point

===Change log===
'''known issues of v7.1.x'''
* FURN particle not yet supported by export
* not compatible with OBJ drag and drop plug-in (it appears to be taken down anyway)

'''known issues of v4-v7'''
* manager windows sometime don't ''update'' what results in another opened instance
* slow flag import, I will probably make the flag numbering (textures) optional in a later version (then turned off by default)
* broken weapon depot update function (temporary solution: delete depot and add all dae file to folder)

----
[[Image:OniTools_select_polygon_find_material_then_delete_all_polygons.jpg|thumb|Material-depending polygon cluster deletion: You need to find the material.]][[Image:OniTools_select_polygon_find_material_then_delete_all_polygons_result.png|thumb|Material-depending polygon cluster deletion: before and after image.]]
'''version 7.1.8'''
* material-depending polygon cluster deletion

'''version 7.1.7'''
* [http://web.archive.org/web/20160225030701/http://oni.bungie.org/forum/viewtopic.php?pid=48310#p48310 Animated Rotoscope]

'''version 7.1.1 - 7.1.6'''
* bug fix: TRGV writing/reading
* [https://www.youtube.com/watch?v=yYHaltepyNI CRSA (corpse array) import]
* scaling support for TRGV
* print absolute position and rotation of selected objects
* print relative position and rotation of selected objects
* furniture library (alpha)
* basic OFGA import / FURN export

'''version 7'''
* a "character export (TRAM)" button (select one bodypart and hit the button, it will select the tree automatically)
* the code includes the "Make Rotation Keys Continuous"
* the addon will change your save file settings (to framerate 60 fps)
: one person can send a new *.exp file and the other person can make a *.dae from it
: old *.exp (that were created based on a 30 fps setting) needs to be [[../#Animating|scaled down]] by a factor of 2
* currently removed the features made in version 6 (hopefully we will not need that any longer)

'''version 6'''

* repair major character rotation flips (beta)
** select a body part and set keyframe range and flip amount
** fine-tune problematic zones by hand

'''version 5'''
* pathfinding manager (alpha: ghosts can be created on edges)
* trigger volume manager (plus BINACJBOTrigger Volume'''.oni''' drag'n'drop support)
* bugfix: flag xml code

'''version 4'''
* flag manager (plus BINACJBOFlag'''.oni''' drag'n'drop support)
* "(un)hide" button works now properly

'''version 3'''
* weapon manager (plus BINACJBOWeapon'''.oni''' drag'n'drop support)
* disables transparency on weapon textures
* button to access OniXSI resources folder
* fixes glitchy PPGs (manager windows sometimes switched from "locked" to "refresh" mode, etc.)

'''version 2'''
* better support for future custom resources (check out the readme files in OniXSI resources folder)
** for example new LSIs can be added at ...\Softimage\Softimage_Mod_Tool_7.5\OniXSI_resources\PowerUps\LSI

'''version 1'''
* powerups manager (plus BINACJBOPowerUp'''.oni''' drag'n'drop support)
** LSIs gets imported with a placeholder geometry (there's no easy way to detect what actual LSI is used for a level)
** using LSIs from the manager works though (just keep in mind that levels are fixed to one type of LSI)
* drag'n'drop support for OniSplit update



[[Category:Outdated modding tools]][[Category:Windows-only modding tools]]

Sarai

2025-12-26T05:37:40Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

Sarai is one of the [[BGI characters|new BGI characters]] created by [[User:Samer|Samer]]. The mod which adds this character is available on the forum [http://oni.bungie.org/forum/viewtopic.php?pid=46869#p46869 here]. Sarai is intended to be the female boss of BGI. Second-in-command to the Executives and directly following their orders, she's ruthless, dangerous, highly skilled, and devoted to the BGI. The character concept was developed in the [[Joint Story]] under the name Samako.

The model is based on DarkLitria's sketch seen [[:Image:DarkLitria - Sarai.png|here]]. The head mesh is from a [http://web.archive.org/web/20211207210528/http://oni.bungie.org/forum/viewtopic.php?pid=16272#p16272 project] started by Lapis which was later abandoned, with further modeling and texturing done by Samer.

[[Image:Sarai.jpg]]

[[Category:BGI]][[Category:Modding projects]]

Casual Tankers

2025-12-26T05:37:25Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

Casual Tankers are a pre-beta character class that was dropped some time before release. They can be seen in [https://www.youtube.com/watch?feature=player_detailpage&v=YLZ2hJZvrmo#t=82s this early footage] from Oni's [[Trailers|trailer]], and in these screenshots:
<gallery>
Image:Pre-beta_Airport.jpg
Image:Genesis_Level3_1.jpg
Image:Genesis_Level3_2.jpg
Image:Genesis_Level2_13.jpg
</gallery>

They were reconstructed as playable characters in easy, medium and hard variants by [[User:Samer|Samer]]. The [http://mods.oni2.net/node/216 Casual Tankers mod] can be downloaded through the [[AE|AE Installer]], and has a release thread on the forum [http://web.archive.org/web/20200924105958/http://oni.bungie.org/forum/viewtopic.php?id=2416 here].

[[Image:Casual Tankers mod.jpg|400px]]

Casual Tankers were also the inspiration for Ratslayer's [http://mods.oni2.net/node/431 KTSN Mafia Tankers mod], which can be downloaded through the AE Installer.

[[Image:KTSN Mafia Tankers.jpg|800px]]

[[Category:Syndicate]][[Category:Modding projects]]

Creating an animation rig in Blender

2025-12-26T05:30:58Z

ValBot: replaced Oni Central Forum link with archive.org snapshot URL

{{integrate|See {{SectionLink||Tools and relevant tutorials}}, but this tutorial has also been marked for integration with [[Using the Rigify animation rig]], so check if it has been integrated there already.}}
This tutorial shows you how to create the [http://mods.oni2.net/node/388 animation rig for Blender] (made by geyser) from scratch, with some improvements.

The purpose of this rig is to give us much better tools to animate, compared to our [https://web.archive.org/web/20160225035410/http://oni.bungie.org/forum/viewtopic.php?pid=23698#p23698 previous process in Softimage XSI], which allowed us to animate exclusively with Forward Kinematics. While FK may work for simple, short animations done on characters with a small amount of bones, it does not work well for Oni characters and animations, as it's too labor-intensive and inefficient.

'''If you are looking for information on how to use the rig, please refer to the article on that available [[Using the Rigify animation rig|HERE]].'''

==Prerequisite tutorials==
I highly recommend watching the tutorials below if you feel you're lacking knowledge in any of these subjects:

General Blender basics:
* [https://www.youtube.com/watch?v=RG8qK5zPqgM Wolf's 45-Minute Crash Course for Blender Virgins]

Blender Character Rigging overview showing that you can create a Rigify rig in less than a minute at 5:43, and also rig a character while at it:
* [https://www.youtube.com/watch?v=f2pTkW-1JkE&t=343s Character Rigging – Blender 2.80 Fundamentals]

Practical and intuitive explanation of what Inverse and Forward Kinematics (IK/FK) are – this is explained in Maya, but same principles apply in every 3D editing program including Blender:
* [https://www.youtube.com/watch?v=p6PYKyxR0aY Animating with IK and FK]

Basics of using Rigify:
* [https://www.youtube.com/watch?v=vKgH5zXIYmM Rigify Tutorial #08 – Posing the Rigify rig] by CGDive

Rigify Bone Groups and Layers:
* [https://www.youtube.com/watch?v=5FK4jDCAOkk Rigify Tutorial 7-1: Rigify Bone Groups and Layers (Overview)] by CGDive
* [https://www.youtube.com/watch?v=JZZHCmKFcMs Rigify Tutorial 7-2: Rigify Bone Groups and Layers (Practice)] by CGDive
* [https://www.youtube.com/watch?v=2XldUB2eT-o Rigify Tutorial 7-3: Rigify Bone Groups and Layers (Advanced)] by CGDive

Changing Rigify Custom Shapes and Widgets:
* [https://www.youtube.com/watch?v=beVtWATcw9U Rigify – Custom Shapes/Widgets] by CGDive

Blender custom properties and '''drivers''' (drivers in the rig described here are used to set the influence of its controllers' bone constraints through the Pose1 and Pose2 bone locations):
* [https://www.youtube.com/watch?v=_197jQFh22E Custom properties and drivers in blender made easy] by Pierrick Picaut

===Tracking constraint tutorials===
These explain constraints like Damped Track which are used by Rigify – you can skip this if you want, but it might give you a better idea of how Rigify's MCH (Mechanical) layers work, or come in handy in the distant future; other than that, you don't need to know them to animate for Oni:
* [https://www.youtube.com/watch?v=aGBOu-dNZ-w Tracking Constraints – Blender 2.80 Fundamentals]
* [https://www.youtube.com/watch?v=5FK4jDCAOkk Camera Track To vs Damped Track Constraints | Pros & Cons Explained With Examples | Blender] by 5 minutes Blender

==Things to know before starting==
There are several things worth knowing before you start creating the rig.

===Tools and relevant tutorials===
[[Image:Cmder.png|200px|right|thumb|Screenshot showing Cmder's capabilities within the context of modding Oni.]]
* [http://mods.oni2.net/node/38 '''Current version of OniSplit.'''] This is the tool needed to import and export assets out of Oni. '''DO NOT USE OniSplit GUI or Vago for importing Oni assets into Blender''' – neither of these weren't updated in a long time, and thus they don't support OniSplit's v0.9.99.2 -blender option. You can still use them for other purposes though, such as sounds and converting .oni files to XMLs, etc.
* [https://cmder.app/ '''Cmder'''] (Windows only) – because OniSplit is a command line tool, it is highly recommended to get any upgrade to Windows' Command Prompt. As shown in the screenshot on the right, Cmder allows you to start it from the context menu in any selected folder, and it also remembers your most recently used commands, vastly improving your workflow when you're forced to use any command line tools.
* [https://docs.blender.org/manual/en/2.81/addons/rigging/rigify.html '''Rigify'''] – it's a plugin for Blender designed to automate a lot of rigging work. The rig described here is generated using Rigify.
* [https://docs.google.com/document/d/175uJGklYASAgrFjxuUG4-kJRDoMTjjP7GvNxSj1GscU/edit '''Oni-Blender tutorial'''] by EdT. Please read this in entirety to know likely-to-happen issues and refer to this as your guide for OniSplit commands relating to Blender.
* [http://web.archive.org/web/20211202215118/http://oni.bungie.org/forum/viewtopic.php?pid=23230#p23230 '''Brief overview on creating TRAMs'''] by EdT – while this was written with XSI in mind, this is still relevant as the process for preparing the XML files for Oni is still the same. Also the next post in that thread, called '''Brief walk through on modifying a TRAM,''' is an example of that overview put into practice.

===Assorted issues in Blender===
Please refer to [[Blender#Oni-specific_issues_with_Blender|THIS]] section of the "Blender" article for issues that you will run into while Oni modding.

==Overview of the rig==
Here is an overview of how the rig works: As stated before, our previous animating process was limited to FK only, which is inefficient for Oni. So instead we desperately needed an IK/FK capable rig, to which we would be able to snap a character, so we could animate him/her.

At the same time, the rig would have to be capable of the opposite thing – snapping itself to the animated character. That's because most often the way we start out with making a new animation is copying the first or last frame of the preceding animation. This functionality has been implemented, and is called Pose Matching. The way it works is simple – it uses bone constraints in rig controller bones targeting the character model in order to snap the rig to the model.

The rig uploaded on Oni Mod Depot contains three Konokos by default: One T-Posed Konoko and two animated ones, all stored in their own collections. The T-Posed Konoko is there because it was easiest to build the rig off a T-Pose, while the remaining two ones, stored in Pose 1 and Pose 2 collections, is where you are supposed to store your animated characters, to which you can Pose Match, and thus check if Pose Matching works as intended.

Because Oni does not store its animations in form of an armature, but rather as locations and rotations of 19 objects organized in a parent-child relationship, this forces us to use the earlier mentioned object and bone constraints. This is also creates a big problem: in order to animate, rotation and location data from the 19 character body parts have to be transformed onto the rig, and then the body parts have to be constrained to the rig. Once you are done animating and you want to export your animation, you have to do the reverse: transform the animation from the rig onto the 19 body parts, and then disable the constraints. This is quite inconvenient, because all of the constraints (and there's a lot of them) in both the body parts and rig have to be turned on and off.

The general workflow of making animations using this rig is the following, assuming you want to make a single animation (i.e. you don't want to make a throw animation):

# Open up a Blender scene containing the rig.
# Delete either the model in Pose1 or Pose2.
# (OPTIONAL) Assuming you want to animate a different character, delete the T-posed model.
## Import your desired character with textures using -noanim.
# Import the animation you are using as a starting point.
## If you did point 3, apply the textures on the animated model.
# Using the RigBoneConstraintTargetSetter script available [[Blender/Obsolete scripts#Rig bone constraint target setting script|HERE]], set the targets of the rig's bone constraints to be the body parts of the animation you've imported.
# Using the Pose Matching functionality, constrain the rig to the imported animation (Set the IK-FK sliders on rig limbs to 1, as Pose Matching works only through FK controllers)
# For each frame that you want to remain in your animation, while having all the bones selected (or the ones you want), press Ctrl+A, select Apply Visual Transform to Pose and keyframe it.
# Disable bone constraints on the rig using the BoneConstraintEnabler script available [[Blender/Obsolete scripts#Script for enabling.2Fdisabling bone constraints in the selected armature|HERE]].
# '''Make your animation.'''
# Once your animation is ready, use the Visual Transformer script available [[Blender/Obsolete scripts#Visual transformer script|HERE]] to bake the rig keyframes into the character model.
# Using the ObjectConstraintEnabler script available [[Blender/Obsolete scripts#Script for enabling.2Fdisabling constraints in selected objects|HERE]], disable the object constraints on the character model. '''The character model should now be animated and have the needed rotations and locations.
# Export the animation as a DAE.

==Importing animations and preparing the Blender scene==
'''The actual tutorial starts here.'''

For detailed explanation of the required OniSplit commands, please refer to the '''Oni-Blender Tutorial by EdT''' listed in the '''Tools and relevant tutorials'''.

[[Image:ARB SceneUponImportingKonokos.png|400px|right|thumb|The expected result by the end of this section.]]

# Using OniSplit, export any character you want as a DAE (-extract:dae) using -noanim (T-Pose) and -blender arguments.
## As per EdT's '''Oni-Blender Tutorial''', you should get <tt>AnimationDaeWriter: custom axis conversion</tt> in OniSplit output if you've used the -blender argument. If you didn't get that on the output, it means something most likely went wrong and you won't be able to import the model into Blender (or you will be able to import it but it will be wrong).
## Assuming you wanted a textured model and thus you've exported an ONCC, you should now get a '''DAE file''' and an '''''images''''' folder containing the textures for it.
# Using OniSplit, export any two animations as an XML (-extract:xml) using -anim-body (lets you specify the character you want) and -blender arguments.
## You should get '''one DAE and an XML file for each animation, totalling four files.'''
# Open up Blender and set your scene's frame rate to 60 FPS. If you don't, the keyframes of the imported animations will get tightened up together, because Blender's default scene frame rate is 24 FPS.
# Import the -noanim model into Blender first ('''MAKE SURE YOU CHECK THE ''Import Unit'' BOX''', otherwise you will import the model with arbitrary units which will break everything and will be basically unadjustable later)
# Import the animations into Blender ('''ALSO MAKE SURE YOU CHECK THE ''Import Unit'' BOX EACH TIME''')
# At this point the -noanim/T-posed model in the scene should have no suffix in its body part names, while the animated models should have ''.001'' and ''.002'' suffixes. This is intended; the T-posed model will serve for building the metarig and editing the rig once it's generated, while the animated models are needed for pose matching purposes, where the suffixes are useful for setting up the bone constraints.
# Create three new collections in the Outliner, name them ''T-pose'', ''Pose 1'' and ''Pose 2''. These three collections allow you to quickly hide the respective models from the Viewport using the eye icon in the Outliner.
## Move the T-Posed model to ''T-pose'', and move ''.001'' and ''.002'' animated models to ''Pose 1'' and ''Pose 2'' collections respectively.
# If you've imported the textured model, [[Blender#Lack of textures on animated models|apply textures to the animated models]] and [[Blender#Alpha transparency issue|fix the alpha transparency issue]].
# At this point, your scene should look as shown in the screenshot on the right.
# You can hide the Pose 1 and Pose 2 collections – they won't be changed in this tutorial anymore.

==Adjusting T-posed model's Z location==
At this moment the T-posed model is sunk to the ground. That's because the pelvis location is set to 0,0,0. All of the animations in Oni have their heights adjusted [[XML:TRAM#List_of_tags.2C_types.2C_and_flags|(through the <Height> tags)]] so that the pelvis is roughly at Z ~ 0.9, so that the characters appear standing on the floor instead of, again, sinking into it. For this reason, we want to adjust the position of the pelvis so that the feet soles are aligned with the floor.

[[Image:PelvisZLocation.png|400px|right|thumb|The expected result by the end of this section.]]

# <li value="10">Adjust the Z position of the T-posed model's Pelvis in one of the two ways:</li>
## Simply switch to Front Orthographic view (Num 1) and move the Pelvis along the Z axis so that the feet soles are roughly aligned with the floor. This will work, but if you want 100% accuracy, use the method below.
## The 3D Cursor snapping method:
### Select one of the feet in Object mode.
### Switch to Edit mode.
### Select one of the lowest-reaching vertices on the foot and Snap Cursor to Active. (Shift + S, 3)
### Switch back to object mode.
### Select the Pelvis.
### Snap Selection to Cursor. (Shift+S, 8)
### Set the X and Y locations of the pelvis to 0.
### Invert the Z location of the pelvis.
### The pelvis should be now at Z ~ 0.9 with feet soles perfectly aligned with the floor.
# At this point, your scene should look as shown in the screenshot on the right.

==Creating the Rigify metarig and adding limb flexion==
This part describes how to create a Rigify metarig and how to adjust it so that it matches the T-posed model body parts.

# <li value="12">Before you proceed to create the rig, you need to add small rotations to the limbs, which will allow Rigify to know in which direction the elbows and knees are going to bend. Otherwise, the rig will not function properly.</li>
## Add the following Z rotations to the respective body parts in accordance with the list below:

{| class="wikitable"
|-
! Z rotation !! Bones
|-
| -5 || <ul><li>right_thigh <li>left_thigh <li></ul>
|-
| -10 || <ul><li>right_calf <li>left_calf <li>right_wrist <li>left_wrist </ul>
|-
| 5 || <ul><li>right_biceps <li>left_biceps <li> right_handfist <li>left_handfist <li>right_foot <li>left_foot</ul>
|}

# <li value="13">Enable Rigify in Blender if you haven't already – you can do that by going to Edit / Preferences / Addons and looking it up, as Rigify comes with by Blender by default.</li>
# Add a Basic Human Metarig to the scene. ( Add Menu / Armature / Basic / Basic Human (Meta-Rig) )
## Scale the rig by 10 or so that it's roughly the size of the character.
## Apply the scale. ( Object / Apply / Scale )
# Go to Metarig's Object Data Properties tab and:
## Open Viewport Display,
## Check ''In Front'' box to make the metarig easier to select when your Viewport is in Solid or Material Preview shading modes,
## Check the ''Axes'' box to see the local axes of each bones – this makes their rolls easier to understand.
# Remove the following bones from the Metarig:
*pelvis.L
*pelvis.R
*breast.L
*breast.R
*spine.005
*spine.006
# <li value="17">Go to Edit mode, select Bone Properties tab and change the ''Connected'' box of the following Metarig's bones accordingly to the below table:</li>

{| class="wikitable"
|-
! Bone || Connected
|-
| spine.003 || Disable
|-
| spine.004 || Enable
|-
| shoulder.l || Enable
|-
| shoulder.r || Enable
|}

# <li value="18">The default Rigify bone layer order is highly unergonomic. For this reason, reassign the following bones to bone layers in accordance with the table below. You can reassign bones' bone layers by selecting them and pressing M. Make sure you have enabled User Tooltips in Preferences / Interface – that way when you move your cursor over the layer box, a tooltip will display the layer number.</li>

{| class="wikitable"
|-
! Bones !! Bone layer
|-
| <ul><li>spine <li>spine.001 <li>spine.002 <li>spine.003 <li>spine.004 <li>shoulder.l <li>shoulder.r </ul> || 8
|-
| <ul><li>upper_arm.L <li>forearm.L <li>hand.L </ul> || 0
|-
| <ul><li>upper_arm.R <li>forearm.R <li>hand.R </ul> || 16
|-
| <ul><li>thigh.L <li>shin.L <li>foot.L <li>toe.L <li>heel.02.L </ul> || 4
|-
| <ul><li>thigh.R <li>shin.R <li>foot.R <li>toe.R <li>heel.02.R </ul> || 20
|}

# <li value="19">Go to Pose mode, select Bone Properties tab and open the Rigify Type box.</li>
# Set ''Limb Segments'' and ''B-Bone Segments'' to 1 on the bones listed below. Because Oni uses rigid body parts, Limb Segments and Bendy bones are not needed.
* upper_arm.L
* upper_arm.R
* thigh.L
* thigh.R

# <li value="20"> Disable ''Assign Tweak Layers'' checkbox on the bones listed below.</li>
* upper_arm.L
* upper_arm.R
* thigh.L
* thigh.R
* spine

# <li value="21"> Remove ''rig type'' on the ''spine.004'' bone.</li>
# Set ''rig type'' on the ''spine.003'' bone to ''spines.super_head''.
# Enable the ''Connect chain'' checkbox on the ''spine.003'' bone.
# Disable the ''Widget'' checkbox on the ''shoulder.L'' and ''shoulder.R bones''.
# Set ''pivot_position'' on the ''spine'' bone to 1.
# Enable the ''Custom Pivot Control'' checkbox on the ''spine'' bone.
# Assign Tweak Layer of spine.003 to 9.
# Assign FK layers for the following bones in accordance with the table below:

{| class="wikitable"
|-
! Bones !! Bone layer
|-
| <ul><li>spine <li>spine.003</ul> || 9
|-
| upper_arm.L || 1
|-
| upper_arm.R || 17
|-
| thigh.L </ul> || 5
|-
| thigh.R </ul> || 21
|}

# <li value="29">Now you need to adjust the metarig's bones so that they match up with character body parts. In order to reduce the amount of needed work, switch to Edit Mode and check the X-Axis Mirror either in Options or the Tool tab.</li>
# Switch to Object mode and using the Snapping Cursor to Active, and Snapping Selection to Cursor in the Snap menu (Shift + S), keep snapping cursor to model's body parts, selecting the Metarig, switching to Edit mode, selecting the appropriate bone and snapping it to 3D Cursor. '''I believe it is intuitive which bones should be snapped to which body parts, therefore there is no need for a table describing that, with the exception of hints on what should be done about spine.004, hand.L, hand.R, toe.L, toe.R, heel.02.L and heel.02.R.'''
## There is actually nothing you need to do about the heel bones, leave them as they are.
## Snap the tails of spine.004, hand.L and hand.R to their heads and move them along the axis they're pointing at, to some whatever point that makes sense to you, e.g. furthest reaching vertex on the hand. No need to be precise here, and thus snapping – just move the tail so that it is roughly where you want it to be.
## In order to keep the toe bones aligned and properly positioned, do the following for each toe bone:
### Select the foot in object mode,
### Snap cursor to the furthest and lowest reaching vertex on the foot,
### Copy the X location of that vertex,
### Snap the bone to cursor,
### Paste the X location to the bone's head,
### Snap bone's tail to the head,
### Move the head along the Y axis by some amount will make it easy to select but not too big.
# In edit mode, set the following rolls for the Metarig bones as described below (if you don't, body parts, mainly shoulders, will get badly rotated after constraining them to the rig after its generation):
## shoulder.L, 90 degrees,
## shoulder.R, -90 degrees,
## ''All'' other bones, 0 degrees.
# Now we have to set up how our Rigify rig layers will be named and set up. Go to the Object Data Properties tab, open up Rigify Layer Names, and set the table according to the screenshot below, marked as Point 32.
# The metarig is now correctly adjusted. Your scene should look as shown in the screenshot below, marked as Point 33.
# We highly recommend to save your project here and to continue your work in a new file (i.e. save, then save as a new file and continue your work on the new file), so that you can revert to the version you had until now and adjust the Metarig if needed. You can skip this, work on a single file, adjust the metarig, delete your current rig and generate a new one, but it may or may not be less convenient to rename.
# Generate the rig. Congratulations, you have generated the rig and can move to constraining the character to it. Your scene should look as shown in the screenshot below, marked as Point 35.

{| class="wikitable"
|-
| [[Image:RigifyLayerNames.png|300px|frameless]] || [[Image:Metarig.png|400px|frameless]] || [[Image:Rig.png|400px|frameless]]
|-
! Point 32, Rigify layer names for the rig !! Point 33, fully adjusted Metarig. !! Point 35, generated rig.
|}

==Constraining the character to the rig and adding the Axis Correction Empties==
Now we get to constrain the character to the rig and later edit the rig. Unfortunately, there's even more work in editing the rig than with the metarig.
# <li value="36">Hide the metarig, it won't be needed anymore.</li>
# On the Pelvis of the T-posed character, add two Copy Rotation object constraints with the settings according to the table below. "x" means there's nothing set.
{| class="wikitable"
|-
! Setting !! Copy Rotation !! Copy Rotation.001
|-
| Target || rig || x
|-
| Order || ZYX Euler || Default
|-
| Mix || Replace || After Original
|}

# <li value="37">Copy the constraints to all of the remaining body parts.</li>
# At this point, the character is folded into Oni's default pose, described [[Importing_character_models#Oni.27s_default_orientation|HERE.]] This is hard to work with, so disable all of the object constraints with the ObjectConstraintEnabler script available [[Blender/Obsolete scripts#Script for enabling.2Fdisabling constraints in selected objects|HERE]]. We will also fix the folded pose in a moment.
# Add a ''Copy Location'' constraint to the ''Pelvis'' and:
## Set the ''Target to ''rig'',
## Set the ''Bone to ORG-spine''.

# <li value="40">Now we need to fix the folded pose. This is done through a set of Empties with specified rotations, which are added to the rotation of each body part through the ''Copy Rotation.001'' constraint (this is also why the Mix of that constraint was set to ''After Original'').</li>
## Create a new collection in the Outliner called "''Axis Correction Empties''".
## Add six Arrows Empties, all with their Name showing in the Viewport Display. (Object Properties / Viewport Display / Name)
## Name the empties and place them in the proposed arbitrary positions using cursor snapping, and set their rotations according to the table below – you can place them however you want, as their location does not influence the rig in any way, however, proper placement makes them easy to edit if needed. It's also proposed to place the empties one meter either in front or behind the given body part.

[[Image:AxisCorrectionEmptyPlacement.png|200px|right|thumb|Proposed Axis Correction Empties' placement]]

{| class="wikitable"
|-
! Empty !! Body Part !! In front of or behind? || X rotation || Y rotation || Z rotation
|-
| ACFeet || Either foot || Behind || -90 || -52.5 || 90
|-
| ACHandL || left_handfist || Behind || 180 || 0 || 90
|-
| ACHandR || right_handfist || Behind || 0 || 0 || 90
|-
| ACLimbs || neck || Behind || -90 || 0 || 90
|-
| ACPelvis || pelvis || Front || 90 || 8.6 || 90
|-
| ACSpine || mid || Front || 90 || 0 || 90
|}

::#<li value="4"> In your Viewport, open the Viewport Overlay and enable Relationship Lines. These are the lines that will show you lines from constrained objects to their targets. They will give you a better sense of how body parts are copying rotations from the Empties you are about to make. You can also turn Relationship Lines off at any point if they're making the scene hard to read.</li>
::# Set the ''Bones'' of ''Copy Rotation'' and ''Targets'' of ''Copy Rotation.001'' constraints in character's body parts in accordance with the table below. The table may be intimidating, but it should be logical enough and easy to copy and paste the targets and bones – all of the body parts get targeted to a corresponding ORG bone in the rig through ''Copy Rotation'' and get their Axis Correction rotation added through ''Copy Rotation.001'' set to appropriate empty.

[[Image:RigCharacterConstrained.png|600px|right|thumb|Expected result by the end of this header]]

{| class="wikitable"
|-
! Body part !! Copy Rotation / Bone !! Copy Rotation.001 / Target
|-
| pelvis || ORG-spine || ACPelvis
|-
| mid || ORG-spine.001 || ACSpine
|-
| chest || ORG-spine.002 || ACSpine
|-
| neck || ORG-spine.003 || ACSpine
|-
| head || ORG-spine.004 || ACSpine
|-
| right_shoulder || ORG-shoulder.R || ACLimbs
|-
| right_biceps || ORG-upper_arm.R || ACLimbs
|-
| right_wrist || ORG-forearm.R || ACLimbs
|-
| right_handfist || ORG-hand.R || ACHandR
|-
| left_shoulder || ORG-shoulder.L || ACLimbs
|-
| left_biceps || ORG-upper_arm.L || ACLimbs
|-
| left_wrist || ORG-forearm.L || ACLimbs
|-
| left_handfist || ORG-hand.L || ACHandL
|-
| right_thigh || ORG-thigh.R || ACLimbs
|-
| right_calf || ORG-shin.R || ACLimbs
|-
| right_foot || ORG-foot.R || ACFeet
|-
| left_thigh || ORG-thigh.L || ACLimbs
|-
| left_calf || ORG-shin.L || ACLimbs
|-
| left_foot || ORG-foot.L || ACFeet
|}

#<li value="41">Enable the object constraints in the character body parts using the ObjectConstraintEnabler script.</li>
# At this point, you should be able to pose the character, as shown in the screenshot on the right.

==Removing and editing the rig bones==
There are still things to do; if you play around posing your character, you will find out the spine behaviour to be somewhat lackluster, and lacking control over the mid and chest bones. This will now be addressed, and later, bone constraints need to be added to rig controller bones. Let's start off with deleting all the controller bones we don't need.

#<li value="43">Select the rig, go to Object Data Properties, Viewport Display and enable In Front. The rig will now always render in front of the character, making it easier to select.</li>
# In Edit mode, go to Object Data Properties tab / Skeleton, select Layer 29 (the DEF/Deform) and delete all bones in it.
# Select layer 28, and move the root bone to layer 24 (Change Bone Layer, default shortcut is M)
# Remove the bones listed below from the rig. Keep in mind it's possible to enable just one layer at a time for your convenience. For the record, we will not be editing MCH or ORG layers until later, so you can ignore their layers for now. '''IMPORTANT NOTE: Be sure to not delete tweak_spine.001 accidentally, as it's necessary for the rig to function properly.'''

{| class="wikitable"
|-
! Bone !! Layer
|-
| tweak_spine || Torso
|-
| tweak_spine.002 || Torso
|-
| tweak_spine.003 || Torso (Tweak)
|-
| spine_fk.001 || Torso (Tweak)
|-
| spine_fk.002 || Torso (Tweak)
|-
| upper_arm_tweak.L || Arm.L (IK)
|-
| forearm_tweak.L || Arm.L (IK)
|-
| hand_tweak.L || Arm.L (IK)
|-
| upper_arm_tweak.R || Arm.R (IK)
|-
| forearm_tweak.R || Arm.R (IK)
|-
| hand_tweak.R || Arm.R (IK)
|-
| thigh_tweak.L || Leg.L (IK)
|-
| shin_tweak.L || Leg.L (IK)
|-
| foot_tweak.L || Leg.L (IK)
|-
| thigh_tweak.R || Leg.R (IK)
|-
| shin_tweak.R || Leg.R (IK)
|-
| foot_tweak.R || Leg.R (IK)
|}

#<li value="47">Using 3D Cursor snapping, snap ''torso'' and ''torso_pivot'' bones to the ''mid'' body part.</li>
##Since ''torso'' and ''torso_pivot'' are of the same size, etc. and thus are overlapping each other, feel free to move their tails a bit in the appropriate axis. This applies to all overlapping bones in the rig – if they overlap, move the tail in the axis parallel to the bone.
#Reparent ''shoulder.L'' and ''shoulder.R'' bones from ''ORG-spine.003'' to ''ORG-spine.002''.
# Controller bones are now adjusted, and we can move on to ORG and MCH layers. Select the ORG layer (31), reparent the bones and set their ''Connected'' box according to the table below. '''x''' means no change is needed.

{| class="wikitable"
|-
! Bone !! Parent !! Connected
|-
| ORG-spine || root || x
|-
| ORG-spine.001 || ORG-spine || Yes
|-
| ORG-spine.002 || ORG-spine.001 || Yes
|-
| ORG-shoulder.L || ORG-spine.002 || x
|-
| ORG-shoulder.R || ORG-spine.002 || x
|-
| ORG-upper_arm.L || x || No
|-
| ORG-upper_arm.R || x || No
|}

#<li value="50">Select the MCH layer (3) and remove the following bones:</li>
#*MCH-thigh_tweak.L
#*MCH-thigh_tweak.R
#*MCH-shin_tweak.L
#*MCH-shin_tweak.R
#*MCH-foot_tweak.L
#*MCH-foot_tweak.R
# Snap ''MCH-torso.parent'' and ''MCH-torso_pivot'' to the ''mid'' body part. (You can also snap them to ''MCH-spine'' or ''MCH-spine.001'' bones as they're snapped to ''mid'' as well)
# With X-Axis mirror enabled, select the MCH-forearm_ik.R bone and extrude it perpendicularly to the axis of the arm. You should now have the MCH-forearm_ik.R.001 and MCH-forearm_ik.L.001 bones. These bones are needed for the wrist snapping function which we'll implement later.

==Editing the bone constraints of ORG and MCH bone layers==
Now's the time to edit and add bone constraints.

#<li value="53">Switch to Pose mode and add a ''Copy Rotation'' bone constraint to MCH-forearm_ik.R.001 and MCH-forearm_ik.L.001 bones that you've added in previous points, targeting MCH-forearm_ik.R and MCH-forearm_ik.L bones (i.e. for the ''MCH-forearm_ik.R.001'', ''Target'' is ''rig'', while ''Bone'' should be set to ''MCH-forearm_ik.R.001'')</li>
# Select the ORG layer.
# Add bone constraints in accordance to the table below.

{| class="wikitable"
|-
! Bone !! Bone Constraint !! Target !! Target/Bone
|-
| ORG-spine || Copy Transforms || rig || MCH-WGT-hips
|-
| ORG-spine.001 || Copy Rotation || rig || tweak_spine.001
|-
| ORG-spine.002 || Copy Transforms || rig || MCH-WGT-chest
|}
#<li value="55">Delete the ''Stretch to'' bone constraint from ''ORG-spine.003''.</li>
#Set the ''Bone'' in the ''Copy Transforms'' bone constraint in ''ORG-spine.003'' to ''neck''.
#Select the MCH layer.
# Select the MCH-pivot bone.
## Set the Influence of the Copy Transforms bone constraint to 1.
## Add a Copy Rotation bone constraint, set it to rig / ORG-spine.002 and set its influence to 0.5.
# Select the MCH-spine.001 bone, and set the Influence of the Copy Transforms bone constraint to 0.
# Select the MCH-spine.002 bone.
## Set the Influence of the Copy Transforms bone constraint to 1.
## Add a Copy Location bone constraint, and set it to rig / ORG-spine.002.
# Select the MCH-STR-neck bone.
## Set the Rotation of the Stretch To bone constraint from Swing to XZ.
## Add a Damped Track bone constraint.
### Move it to the top of the bone constraint list.
### Set it to rig / head.
### Set the Track Axis to Y if it isn't already.
# For both MCH-upper_arm_ik_stretch.L and MCH-upper_arm_ik_stretch.R bones, do the following:
## Set the Rotation of the Stretch To bone constraint from Swing to XZ.
## Add a Damped Track bone constraint.
### Move it to the top of the bone constraint list.
### Set it to rig / hand_ik (.L or .R appropriately if it's a right or left hand).
### Set the Track Axis to Y if it isn't already.
# For both MCH-thigh_ik_stretch.L and MCH-thigh_ik_stretch.R bones, do the following:
## Set the Rotation of the Stretch To bone constraint from Swing to XZ.
## Add a Damped Track bone constraint.
### Move it to the top of the bone constraint list.
### Set it to rig / MCH-foot_roll (.L or .R appropriately if it's a right or left leg).
### Set the Track Axis to Y if it isn't already.
# Disable the ''Stretch'' checkbox in both of the IK bone constraints in the following bones:
#*MCH-forearm_ik.L
#*MCH-forearm_ik.R
#*MCH-shin_ik.L
#*MCH-shin_ik.R

==Changing custom shapes of rig controller bones==
We're getting close to the end. There's still a bit of work to do, but all that remains relates to the rig controller bones in Pose mode.
This short header will focus on changing the shapes of the controller bones – these changes are purely visual and have no functional effect on the rig, however, they do make it more more ergonomic and easier to read.
[[Image:Rig After Editing Custom Shapes.png|200px|right|thumb|Rig's expected state at point 69.]]
#<li value="65>Switch over to all other bone layers except the MCH and ORG layers – all that was related to them is now done.</li>
#Select the tweak_spine.001 bone:
## Set the Custom Object to WGT-rig_thigh_parent.L – this will make it much more easier to read.
## Set the Scale to 1.5.
## Disable the ''Scale to Bone Length'' checkbox.
# Select the spine_fk bone:
## Disable the ''Scale to Bone Length'' checkbox.
## Set the Scale to 0.
#For both hand_ik.R and hand_ik.L bones, disable the ''Scale to Bone Length'' checkbox.
#For both foot_ik.R and foot_ik.L bones, do the following:
## Disable the ''Scale to Bone Length'' checkbox.
## Set the Scale to 2.
#For both toe.R and toe.L, set the scale to 0. At this point, the rig should look as shown in the screenshot on the right.

==Editing the rig_ui.py script==
Now we'll need to edit the Rig Layers panel a bit and add the wrist snapping functionality by putting three code snippets into rig_ui.py and running it.

#<li value="71"> Go to the Scripting tab and select the rig_ui.py script.
#Right at the start of the script you will see the <code>rig_id</code> field. Copy its value and save it in some text editor, as you'll be pasting it in the next few steps.
#Find the following line (use another text editor if you can't find it in Blender's Text Editor):

<pre> props.bones = '["upper_arm_ik.L", "upper_arm_ik_target.L", "hand_ik.L"]'</pre>

Add the following code snippet below it – this will add a button and functionality for the wrist snapping on the '''left''' arm – using the MCH-forearm_ik.L.001 bone that was created in points 52 and 53.
Also, replace <code>'''YOURRIGID'''</code> with your <code>rig_id</code> from point 71.

<pre>
group2 = group1.row(align=True)
props = group2.operator('pose.rigify_generic_snap_YOURRIGID', text='IK wrist (hand.L)', icon='SNAP_ON')
props.output_bones = '["hand_ik.L"]'
props.input_bones = '["MCH-forearm_ik.L.001"]'
props.ctrl_bones = '["MCH-forearm_ik.L.001"]'
props.tooltip = 'IK hand to wrist'
</pre>

#<li value="74"> Find the following line:
<pre> props.bones = '["upper_arm_ik.R", "hand_ik.R", "upper_arm_ik_target.R"]' </pre>
Add the following code snippet below it – this will add a button and functionality for the wrist snapping on the '''right''' arm. Also, replace <code>'''YOURRIGID'''</code> with your <code>rig_id</code> from point 71.

<pre>
group2 = group1.row(align=True)
props = group2.operator('pose.rigify_generic_snap_YOURRIGID', text='IK wrist (hand.R)', icon='SNAP_ON')
props.output_bones = '["hand_ik.R"]'
props.input_bones = '["MCH-forearm_ik.R.001"]'
props.ctrl_bones = '["MCH-forearm_ik.R.001"]'
props.tooltip = 'IK hand to wrist'
if is_selected({'upper_arm_ik.R', 'hand_ik.R', 'upper_arm_parent.R', 'upper_arm_ik_target.R'}):
</pre>

#<li value="75"> Find the following line:

<pre> row.prop(context.active_object.data, 'layers', index=8, toggle=True, text='Torso') </pre>

Change it to the following:

<pre>
row.prop(context.active_object.data, 'layers', index=9, toggle=True, text='Pose Matching')

row = col.row()
row.separator()
</pre>

#<li value="76"> Find the following line:
<pre> row.prop(context.active_object.data, 'layers', index=9, toggle=True, text='Torso (Tweak)')</pre>

Change it to the following:
<pre> row.prop(context.active_object.data, 'layers', index=8, toggle=True, text='Torso')</pre>

[[Image:IKWrist.png|200px|right|thumb|Rig's expected state at point 80.]]
[[Image:ModifiedRigLayers.png|200px|right|thumb|Rig's expected state at point 80, with hand_ik.R selected, showing the newly added IK wrist snapping functionality.]]

#<li value="77">Find the following code:</li>
<pre>
row.prop(context.active_object.data, 'layers', index=21, toggle=True, text='Leg.R (FK)')

row = col.row()
row.separator()
</pre>

Remove the <code>row = col.row()</code> and <code>row.seperator()</code> lines.

#<li value="78"> Find the following line:

<pre> row.prop(context.active_object.data, 'layers', index=28, toggle=True, text='Root')</pre>

Change the value of <code>index</code> to 24. Index is the layer number, and Root should be layer 24, not 28.

#<li value="79">We recommend backing up your file at this point.
#Run the script, and move to the Layout tab. Your rig should look as shown in the screenshots on the right.

==Adding the Rigify Axis Correction Empties==
Before we add the Pose Matching functionality, we need to create Axis Correction Empties that will account for Rigify's axis orientation.
#<li value="81">Switch to Object Mode.
#Duplicate the ''Axis Correction Empties'' collection and rename it to ''Rigify Axis Correction Empties''
## Rename the ACPelvis.001 to RACHead and move it in the global Z axis so that it is aligned with the head along the Y axis (or 3D cursor snap it)
## Rename the remaining empties in the newly-made collection by removing the ''.001'' suffix and changing the ''AC'' prefix to ''RAC''.
## Set the rotations of the empties according to the table below:

{| class="wikitable"
|-
! Empty !! X rotation || Y rotation || Z rotation
|-
| RACFeet || 38.1 || 90 || 0
|-
| RACHandL || -180 || 0 || 90
|-
| RACHandR || 0 || 0 || -90
|-
| RACHead || -90 || -90 || 0
|-
| RACLimbs || 90 || 90 || 0
|-
| RACSpine || 180 || -90 || 0
|}

==Adding bone constraints to rig controller bones and drivers==
This is the final section of this tutorial. Now we just have to add the Pose Matching functionality, so we can constrain the rig to imported animations in Pose 1 and Pose 2 collections. We do that by adding two new bones to the rig, bone constraints to the rig controller bones and then drivers which will control the influence of the bone constraints through the Z location of the newly added bones. We will also

#<li value="83">Select the rig, go to Edit mode and select the Pose Matching layer.
#Add a new bone named ''Pose1''.
#Set its transforms as listed below (or make it as big as you want, this is purely a visual/ergonomic matter):
#*Head X,Y,Z: 1,0,0
#*Tail X,Y,Z: 1,0,1
#Duplicate the bone and rename it to ''Pose2''.
#Set its transforms as listed below (it will be simply mirrored along the X axis)
#*Head X,Y,Z: -1,0,0
#*Tail X,Y,Z: -1,0,1
#Switch to Pose mode.
#For both Pose1 and Pose2 bones, select them, go to Bone Properties tab, Viewport Display, Custom Shape and set the Custom Object to WGT-rig_shoulder.L.
##You can also set the Scale to 10 and disable the ''Scale to Bone Length'' checkbox for them if you want.
#For now, move both Pose 1 and Pose 2 in Global Z axis so that they are below the "floor" (XY plane).
#Select the Torso layer and all of the FK layers in the Rig Layers panel.
#Select the ''hips'' bone.
##Add ''three'' Copy Rotation bone constraints, and move the one without the suffix to the bottom of the list (so the order of the bone constraints going from the top to bottom is ''Copy Rotation.001'', ''Copy Rotation.002'', ''Copy Rotation''). ''Copy Rotation.001'' and ''Copy Rotation.002'' will be used for pose matching, ''Copy Rotation'' will be used for axis correction.
##In the ''Copy Rotation'' constraint, set the ''Mix'' to ''After Original''.
#Now we'll have to add the drivers controlling the influence of each Copy Rotation constraint. As shown in Pierrick Picaut's tutorial, you can do that by right clicking on the Influence value and pressing ''Add Driver'' (same applies to any other property in any other constraint). Once you add a driver, you can edit it either through ''Edit Driver'' or through the Driver Editor – both are selectable within the same menu.
##Add a driver to the ''Influence'' of each ''Copy Rotation'' constraint in accordance with the table below:
{| class="wikitable"
|-
! Copy Rotation.001 !! Copy Rotation.002 !! Copy Rotation
|-
|
*Driver Type: ''Scripted Expression'' (default setting)
*Expression: ''var''
*Amount of input variables: one (default setting)
*Input Variable type: ''Transform Channel'' (default setting)
*Input Variable name: ''var'' (default setting)
*Object: ''rig''
*Bone: ''Pose1''
*Type: ''Z Location''
*Space: ''World Space'' (default setting)
||
Same settings as in Copy Rotation.001, with the exception of:
*Bone: ''Pose2''
||
*Driver Type: ''Scripted Expression'' (default setting)
*Expression: ''max(var1,var2)'' (press Enter to get rid of the invalid expression error, if you have it)
*Amount of input variables: two ('''press ''Add Input Variable''''')

First input variable:
*Input Variable type: ''Transform Channel'' (default setting)
*Input Variable name: ''var1''
*Object: ''rig''
*Bone: ''Pose1''
*Type: ''Z Location''
*Space: ''World Space'' (default setting)

Second input variable:
*Input Variable type: ''Transform Channel'' ('''be sure to change it to this''', added variables have ''Single Property'' set as default)
*Input Variable name: ''var2''
*Object: ''rig''
*Bone: ''Pose2''
*Type: ''Z Location''
*Space: ''World Space'' (default setting)

|}

#<li value="94">You can check if the drivers are working by moving Pose1 and Pose2 bones along global Z axis and checking if the Influence of Copy Rotation bone constraints in ''hips'' or Input Variable values in their drivers change.
#Copy the bone constraints from the ''hips'' bone to the following bones:
#*tweak_spine.001
#*chest
#*shoulder.R
#*shoulder.L
#*neck
#*head
#*upper_arm_fk.R
#*upper_arm_fk.L
#*forearm_fk.R
#*forearm_fk.L
#*hand_fk.R
#*hand_fk.L
#*thigh_fk.R
#*thigh_fk.L
#*shin_fk.R
#*shin_fk.L
#*foot_fk.L
#*foot_fk.R
#Unfortunately, because Blender at this moment does not copy drivers when copying bone constraints, the bone constraints you've just copied are lacking the drivers. Because of this, you have to copy the drivers manually – simply right click on the ''Influence'' value of ''Copy Rotation'' constraint, press ''Copy Driver'', and go through all bones in the upper list and ''Paste Driver'' onto the Influence of the ''Copy Rotation'' in each bone. '''Do this for all three ''Copy Rotation'' bone constraints.'''
#Add two ''Copy Location'' constraints to ''torso'' and ''torso_pivot'' bones, and make sure they're named ''Copy Location.001'' and ''Copy Location.002''.
#Copy Influence Drivers from any of the bones in point 96 and paste them into the ''Influence'' of ''Copy Location'' constraints in ''torso'' and ''torso_pivot'', in accordance with the numbers of bone constraints (e.g. copy the driver from ''hips''' ''Copy Rotation.001'' Influence and paste it into Influence of ''Copy Location.001'' in ''torso'' and ''torso_pivot'').
#Set the ''Copy Rotation'' constraints' Axis correction ''Target'' in accordance with the table below.

{| class="wikitable"
|-
! Bone !! Copy Rotation target
|-
| hips || RACSpine
|-
| tweak_spine.001 || RACHead
|-
| chest || RACSpine
|-
| neck || RACHead
|-
| head || RACHead
|-
| shoulder.R || RACLimbs
|-
| shoulder.L || RACLimbs
|-
| upper_arm_fk.R || RACLimbs
|-
| upper_arm_fk.L || RACLimbs
|-
| forearm_fk.R || RACLimbs
|-
| forearm_fk.L || RACLimbs
|-
| hand_fk.R || RACHandL
|-
| hand_fk.L || RACHandR
|-
| thigh_fk.R || RACLimbs
|-
| thigh_fk.L || RACLimbs
|-
| shin_fk.R || RACLimbs
|-
| shin_fk.L || RACLimbs
|-
| foot_fk.R || RACFeet
|-
| foot_fk.L || RACFeet
|}

[[Image:RigFinished.png|200px|right|thumb|Finished rig showing the pose matching functionality.]]

#<li value="100"> Select any FK (green) bone and set the IK-FK slider to 1. Do this for all four limbs. This has to be done because pose matching works only through FK.
# Using the [[Blender/Obsolete scripts#Rig bone constraint target setting script|RigBoneConstraintTargetSetter script]], set the targets for the ''Copy Rotation.001'' and ''Copy Rotation.002'' bone constraints. You can do that by having the rig in Pose mode, going to the Scripting tab, copying and pasting the script, and running it with <code>prefix</code> value set to 1, and then set to 2.
# If you didn't get any errors, move one of the Pose bones in the global Z axis above the XY plane – the T-posed character should now snap to one of the animations in the ''Pose'' collections, as shown in the screenshot on the right.
# Congratulations! The rig is now ready to be used.

[[Category:Modding tutorials]]