OniGalore - User contributions [en]

BGI characters

2022-09-16T08:33:57Z

Samer: /* BGI Agents */

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://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 [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://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://www.models-resource.com/pc_computer/unrealtournament2004/model/3923/ 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://oni.bungie.org/forum/viewtopic.php?id=2445 here].
[[Image:BGI Heavy Bot.jpg]]

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

File:Bgi agents blackops.jpg

2022-09-16T08:31:22Z

Samer: Category:Mod screenshots

== Summary ==
[[Category:Mod screenshots]]

File:Bgi agents lite.jpg

2022-09-16T08:29:34Z

Samer: Category:Mod screenshots

== Summary ==
[[Category:Mod screenshots]]

Videos

2022-04-24T21:21:39Z

Samer: updating casey video link to new version

Here is a collection of links to some of the Oni-related videos posted on YouTube. Also see YouTube's [https://www.youtube.com/channel/UCa3bHN9Pp4xrzWVtyIPiEZQ/recent Oni - Topic] channel, which automatically collects Oni videos (with some false positives from games/users that have similar names).

==Trailers==
:''See [[Trailers]] for details on the Bungie trailers.''
*[https://www.youtube.com/watch?v=ANQWWqECzI8 Bungie West's 1998 trailer]
*[https://www.youtube.com/watch?v=YLZ2hJZvrmo Bungie's 1999 trailer]
*[https://www.youtube.com/watch?v=kCUJmY7EZeo Oni trailer from Fall 2000 GoD Bonus CD]
*[https://www.youtube.com/watch?v=OmNtNzROvug Rockstar trailer]
*[https://www.youtube.com/watch?v=_cv8X2hc8YE Japanese trailer]

==Early footage==
*[https://www.youtube.com/watch?v=3vKJAZZWIxI Multiplayer at E3, May 1999]
*Multiplayer at Macworld NY, July 1999: [https://www.youtube.com/watch?v=iiBE8N1auuo], [https://www.youtube.com/watch?v=Z3u76geVaio]
*[https://www.youtube.com/watch?v=HOmKXhZJ3b8 Multiplayer at Macworld SF, Jan. 2000]
*Multiplayer at E3, May 2000: [https://www.youtube.com/watch?v=yFQNu-r4TOc], [https://www.youtube.com/watch?v=Sc8crcxjfgM], [https://www.youtube.com/watch?v=8Wp3xqAD4xw]
*[https://www.youtube.com/watch?v=xMJMQdkK9fs Electric Playground S4E7] (E3 coverage with brief Michael Evans interview from 03'47"–03'58")
*[https://www.youtube.com/watch?v=-FmGO67Q_vg Electric Playground S4E10] (Oni is featured from 00'26"–03'10")
*[https://www.youtube.com/watch?v=TaRjTYbUFNY Oni teaser at Macworld NY, July 2000]
*[https://www.youtube.com/watch?v=SO3JUw1dx3A Pre-beta PS2 footage]

==Documentaries and reviews==
*[https://www.youtube.com/watch?v=Yg1mfEvfq_k Oni - Trash or Treasure] by Block's Gaming Reviews*
*[https://www.youtube.com/watch?v=RJO4OB8xdQg Oni: The Other Bungie Game] by Critical Nobody
*[https://www.youtube.com/watch?v=jbrPu15jjPs Demon: The Untold Story of Bungie’s Forgotten Franchise] by CryMor Gaming
*[https://www.youtube.com/watch?v=jNgG8RSHNa8 Oni - Analytical Overview] by EonKool
*[https://www.youtube.com/watch?v=VOawPhCG2dU Gaming History: Oni "The other Best Game Bungie ever made"] by GaminGHD
*[https://www.youtube.com/watch?v=ggC6kfJJE_w Oni Review (Bungie's Forgotten Game)] by GmanLives
*[https://www.youtube.com/watch?v=_LRyxtXkPng Oni: The best Bungie game and its seven-years-late mod scene] by Joe Wintergreen
*[https://www.youtube.com/watch?v=7btzVHh_iXQ Review: Oni] by Nick H
*[https://www.youtube.com/watch?v=Ox6r7aJSRdU Top 10 Forgotten Video Games from Great Developers] by WatchMojo (Oni is #2)
*[https://www.youtube.com/watch?v=6hfFUlraIKQ Oni - Unlikely Review] by Yuusha*

<nowiki>*</nowiki>These reviews are of the PS2 version, and consequently much more negative.

==Intro and outro==
*[https://www.youtube.com/watch?v=du8JepLM-lI Oni Intro]
*[https://www.youtube.com/watch?v=Od1ReWIxduo Oni Outro]

==Gameplay==
*[https://www.youtube.com/watch?v=CDuQHITARk4 Some of Oni's Secrets and Easter Eggs] by Samer
*[https://www.youtube.com/watch?v=r06Q_hEhCg4 Science Prison Lasers] by Samer
*[https://www.youtube.com/watch?v=sSOLSh_aCC8 Grenade Jumping] by loveOni shows how to get to those snipers in Chapter 14 using an SBG
*[https://www.youtube.com/playlist?list=PLFa3CejQbQ2IAihiuD58DLPUraoSccuOt Oni AE Full Levels Gameplay (using several mods)] by Tracker
*[https://www.youtube.com/playlist?list=PLFasmrd0ZfRm80eHfK3g_eDAXJWb0PM5I Oni Let's Play (using Brutal AI, SMP-Conversion, and other mods)] by tens
*[https://www.youtube.com/watch?v=N5dU4IdKlXQ Chasing Mukade] by Loser

==Mods==
===Anniversary Edition===
*[https://www.youtube.com/watch?v=Il46o_ahOds&list=FLtTcOh2t7wRZ5rXzMmWt6xA&index=4 Russian Video showcasing many of the AE mods] by mainfram812
*[https://www.youtube.com/playlist?list=PL_MVvdrljWSR6pnE6zcIByVoasbDBugT0 Oni Playlist featuring many videos using the AE and different level and character mods] by John Thunder

===Characters===
*[https://youtu.be/91-s8CJpeaM Custom Character Casey version 6 demonstrating all new animations, combos, and outfits] by Samer
*[https://www.youtube.com/watch?v=RbfE6k2ulW4 Custom Character Motoko version 3.5 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=ldVEmOV839U Custom Character BGI Sarai demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=KYgNmpLED5M Custom Character Hayate version 2.1 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=Ci44KaCq7UY Custom Characters Jester & Co. demonstrating all moves and combos] by Samer
*[https://www.youtube.com/watch?v=5R8zuI5-EHw Custom Character Kojiro version 2.2 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=9VlUBaQWuXg Custom Character BGI Hammer demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=YtRac64hu6Q Custom Character Rayman Showcase] by Samer
*[https://www.youtube.com/watch?v=NSfeb4xv7p8 Konoko vs. AI Rayman] by Samer
*[https://www.youtube.com/watch?v=4-P82ctyS2E Guard Dogs preview] by EdT
*[https://www.youtube.com/watch?v=iLl9FAoujIs Sentry Droid preview] by EdT
*[https://www.youtube.com/watch?v=yhkTFgEyj28 The Iron Demon Lives] by EdT
*[https://www.youtube.com/watch?v=5whksLNIVmA Iron Demon walking] by EdT
*[https://www.youtube.com/watch?v=I4OCptczD0Q Iron Demon explosion effect] by Loser
*[https://www.youtube.com/watch?v=d2opg2DIGwk Golden TCTF vs. Regenerating Tanker] by Samer
*[https://www.youtube.com/watch?v=MmurRBUbW-U Clash of Titans - BGI Hammer vs. Barabas] by Samer
*[https://www.youtube.com/watch?v=M0ugC6fV-6o Hayate vs. Jester, Casey vs. Hayate, Jester vs. Jubei & Akane] by Samer
*[https://www.youtube.com/watch?v=w-5c5lHjCGA Akane vs. Grey Fury, Jubei vs. Kojiro] by Samer
*[https://www.youtube.com/watch?v=o7NvGBsT-gI Casey combo video in Oni Zen Garden] by Samer
*[https://www.youtube.com/watch?v=vR7Z0Wcuuso Akane combo video in Oni Zen Garden] by Mukade
*[https://www.youtube.com/watch?v=yD6Ai8uufJI Altered Barabas Boss Fight] by Loser (Mod can be found in EdT's Boss Battle Level)
*[https://www.youtube.com/watch?v=QaBDJk9KrNs Barabas New Regeneration] by Gumby
*[https://www.youtube.com/watch?v=ASyyzfIc3D0 Shinibot & Hanako vs. Smart Barabas] by Samer
*[https://www.youtube.com/watch?v=WQZSY8cmj9k Kojiro & Casey vs. Smart Barabas] by Samer
*[https://www.youtube.com/watch?v=kbA4JvcBZFQ Konoko vs. Smart Barabas] by Samer
*[https://www.youtube.com/watch?v=-4Dt_7AmdK0 Konoko vs. Smart Barabas with Jumpable Earthquaker package] by Samer
*[https://www.youtube.com/watch?v=LNUcS_mtHpA Jubei pathfinds] by Gumby & geyser
*[https://www.youtube.com/watch?v=EZ3bai7BhR4 Shapeshifting Montage] by Paradox

===Levels===
*[https://www.youtube.com/watch?v=dtmPmt6YqEE Oni goes to a new Level] by EdT
*[https://www.youtube.com/watch?v=DyOIcie7VGk Omega Tournament Level Preview] by Script10k
*[https://www.youtube.com/playlist?list=PLZQupCr62BGlWdKfx6QV-jArcjDgU64Fs Wilderness Preserve Level Full Walkthrough] by Samer
*[https://www.youtube.com/watch?v=MArbspInwiM SamMegaPack-Fight Club Level Preview] by Samer
*[https://www.youtube.com/watch?v=hg_7FMlyo9M China Level Mod Final Battle] by Script10k
*[https://www.youtube.com/watch?v=CChvV7GTi28 Hanako vs. Hayate and Mukade in China Level Mod] & [https://www.youtube.com/watch?v=CChvV7GTi28 Hanako in Final Battle of China Level] by Samer
*[https://www.youtube.com/watch?v=WZ26KJ46CzE Fight Over the Junkyard] by EdT
*[https://www.youtube.com/watch?v=Wv1IG6QXTMs Oni Custom Characters Good vs. Bad in Junkyard Level] by Samer
*[https://www.youtube.com/watch?v=iKXw5jt3vSE EdT's City Level Parkour Challenge] by Samer
*[https://www.youtube.com/watch?v=QwRzyBGK1yk Oni Tomb Raider Style] showcasing EdT's Parkour Challenge 1 Level by Samer
*[https://www.youtube.com/watch?v=PR_0gddHkNA Parkour Challenge 2 Run] by Tracker
*[https://www.youtube.com/watch?v=GUR66F9rISE SamMegaPack-Conversion Preview] by Samer
*[https://www.youtube.com/watch?v=wwqQHXvCgeQ SamMegaPack-Conversion Final Battle Spared Griffin Version] by Samer
*[https://www.youtube.com/watch?v=e97TCEPhjK0 SamMegaPack-Conversion Final Battle Killed Griffin Version] by Samer
*[https://www.youtube.com/watch?v=Bs8rdGyEpog SamMegaPack-Conversion Dream Lab Preview] by Samer
*[https://www.youtube.com/watch?v=oHCnoThNL2c SamMegaPack-Conversion Skull Team (renamed to Saisei Team) Fights Preview]
*[https://www.youtube.com/watch?v=tE3ZfKzZnOM SamMegaPack-Conversion Atmospheric Interior, Konoko vs Grey Fury] by Samer
*[https://www.youtube.com/watch?v=MIhyHi-C2dY Motoko in Leus' Crazy Casey Mod] by Shella45
*[https://www.youtube.com/watch?v=5PClAPTum8w Leus' Crazy Casey Mod in reverse] by kaargen

===Weapons===
*[https://www.youtube.com/watch?v=9kJF7HSJl04 New Weapons Collection preview] by Samer
*[https://www.youtube.com/watch?v=vrvQjvV0OUA Sniper Mode] by Paradox, demoed by EdT
*Fun with TK Bracelet: [https://www.youtube.com/watch?v=3dE65ZViFl0], [https://www.youtube.com/watch?v=uptSCVabiBY], [https://www.youtube.com/watch?v=OBWUfHlND9Y] by Iritscen
*[https://www.youtube.com/watch?v=1WuMd_fhWbo Phaser rifle demo] by ONIrules

===Animations===
*[https://www.youtube.com/watch?v=tE1xO5K3hi8 New combat Moves for Konoko] showcases new move types like Just Frames and Delayed Animations by Delano762
*[https://www.youtube.com/watch?v=Sbz-3pauSlM Ninja Shadow Dash mod] by Gumby
*[https://www.youtube.com/watch?v=PzMx6SED9gA Prone Mode Revisited] by Paradox
*[https://www.youtube.com/watch?v=hpmqiel9vfQ Barabas using jetpack in Airport Cargo Hangars] by Loser
*[https://www.youtube.com/watch?v=aiN8vmEtvv8 Disarm Revamp demo] by Loser
*[https://www.youtube.com/watch?v=BYYm5AAdpjs Domino Knockdowns demo] by Loser
*[https://www.youtube.com/watch?v=aIbQ1B4pSfM Hit_jewels for females demo] by Loser
*Head2Wall system: [https://www.youtube.com/watch?v=VUM8T06dcn8], [https://www.youtube.com/watch?v=K9c4l8TpTB8], [https://www.youtube.com/watch?v=dCRGTgeFms0]

===Vehicles===
*[https://www.youtube.com/watch?v=5tK9VwQrcp4 Lamborghini Countach rams TCTF HQ] by Iritscen

===Other mods===
*Flatline multiplayer footage: [https://www.youtube.com/watch?v=WZnbVGSyRJU Gumby vs. oxe161], [https://www.youtube.com/watch?v=GMeWr11QVjU Gumby vs. Phydur]
*[https://www.youtube.com/watch?v=aEuAu7jLQQI Projectile dodging patch for AI]
*[https://www.youtube.com/watch?v=RjGgk6SqdeQ Things that go boom] by EdT
*[https://www.youtube.com/watch?v=fec1-bgfCxE Japanese Language Pack special attacks preview] by Gumby
*[https://www.youtube.com/watch?v=bib24bRXuhQ Hidden Treasure Challenge] by Samer
*Good vs. Evil 2.0: [https://www.youtube.com/watch?v=CKhHaG_t0eg video 1], [https://www.youtube.com/watch?v=lzB0I-eeO9o video 2], [https://www.youtube.com/watch?v=dcuF1ABj9D0 video 3] by Iritscen
*[https://www.youtube.com/watch?v=gOHCg8KZM4A Burly Brawl v0.1] by Iritscen
*[https://www.youtube.com/watch?v=zacLylPPTFk Every man for himself on ACC pillar] by EdT
*[https://www.youtube.com/watch?v=-6I78-N_2Yo Fighting Multiple Mukades is Hard] scripted by Loser, demoed by Iritscen
*[https://www.youtube.com/watch?v=TQ8n1oIUW-I Three-Dee Shells vs. Original Shells] by Loser and Iritscen

===Concepts===
*[https://www.youtube.com/watch?v=GFbamj63z8Y AI pathfinding in new level] by EdT
*[https://www.youtube.com/watch?v=Yj3ptZnZtx0 AI pathfinding on uneven ground] by EdT
*[https://www.youtube.com/watch?v=Em6wa5JTQNM Hiding parts of the environment] by EdT
*[https://www.youtube.com/watch?v=iY0eKukGhrM AI Crate jumping] by EdT
*[https://www.youtube.com/watch?v=2RU6asmmrik New animations - Motoko the cheerleader] by EdT
*Playing with moveable objects: [https://www.youtube.com/watch?v=Te9yKA4UR18 cubes], [https://www.youtube.com/watch?v=LUmmLTjSaqQ spheres] by Iritscen
*[https://www.youtube.com/watch?v=YICB7qugrtc Moveable furniture] by EdT
*[https://www.youtube.com/watch?v=ogT1QUblCxc Deadly Van de Graaff Pistol] by Gumby
*[https://www.youtube.com/watch?v=16LqQCPvo2Q Gumby's Death Ray 1] by Gumby
*[https://www.youtube.com/watch?v=bHOMtGDKGSk Gumby's Death Ray 2] by Gumby
*[https://www.youtube.com/watch?v=qccsevDKve0 Dynamic shadow test] by Gumby
*[https://www.youtube.com/watch?v=WzMkNXtfefA Stenciling test] by Gumby
*[https://www.youtube.com/watch?v=VHr7g94sBzE Konoko Regeneration] by Paradox
*[https://www.youtube.com/watch?v=_-o4hMQQU7k AI can intercept player] by Loser
*[https://www.youtube.com/watch?v=eXL9o49I_g0 AI can use Twister Kick and Willow Kick] by Loser
*[https://www.youtube.com/watch?v=CkzguNxjGEs AI Konoko plays Chapter 1 of Oni] by Loser
*[https://www.youtube.com/watch?v=6oTbT6qkcg0 AI has sense of touch, can recognize fallen allies] by Loser
*[https://www.youtube.com/watch?v=pORGOquI_XE Alarm logic demo] by Loser
*[https://www.youtube.com/watch?v=Zgg0fsTs1DU Counter-attack based on Willow Kick] by Loser
*[https://www.youtube.com/watch?v=_n-8SwG_DJk Faster thrower recovery] by Loser
*[https://www.youtube.com/watch?v=ESR_6bgl1dA Female kneegrab demo] by Loser
*[https://www.youtube.com/watch?v=ywk_A6bNHpY Multi-hit Striker Slam] by Loser
*[https://www.youtube.com/watch?v=NQE-LjM9GqM Mukade's Glory] by Loser (the famous pathfinding Mukade video)
*[https://www.youtube.com/watch?v=nlzTajiyl24 Forward knockdown test] by Loser
*Active blocking demos: [https://www.youtube.com/watch?v=EGTwej4nQTM Using timed press of block key], [https://www.youtube.com/watch?v=IKsPMGSomi8 Holding block key] by Loser
*[https://www.youtube.com/watch?v=_7dDjiMnUlw Revised melee collision reactions demo] by Loser
*[https://www.youtube.com/watch?v=zPNINENGLDc Sword animation candidates] by Loser
*[https://www.youtube.com/watch?v=hlQ_JLUI4BA Stun-to-throw demo] by Loser
*[https://www.youtube.com/watch?v=LXiK6rzfMSU Throw-canceling demo] by Loser
*[https://www.youtube.com/watch?v=8ajDTkYPuuM Vulnerable throw victims demo] by Loser
*[https://www.youtube.com/watch?v=lMGpDFNO9m8 Successful railing throws] by Loser

==Modding tutorials==
*[https://www.youtube.com/watch?v=7fQacrVVQLc&list=PLBKEEq8F3prAbbGk6VJkjfLMuMnb-e_gu Creating a Custom Oni Level: Tutorial on building the Omega Tournament Level] by Script10k
*Paradox's Mod Tool tutorials: [https://www.youtube.com/watch?v=CFNseg_2UxA A simple animated object], [https://www.youtube.com/watch?v=w1hLbZPwd2Q Camera interpolation and animation], [https://www.youtube.com/watch?v=yYHaltepyNI CRSA import], [https://www.youtube.com/watch?v=oCo2u8XxVd0 Merging character objects, no FBX required]
*[https://www.youtube.com/watch?v=vDTPYfvMf4M Creating forward throws for Oni with the help of Excel] by Paradox

==Bugs and quirks==
===Vanilla content===
*[https://www.youtube.com/watch?v=0onq6m7oius Infinite loop bug]
*[https://www.youtube.com/watch?v=qbo2Q-VD6dc Idle animations] & [https://www.youtube.com/watch?v=CRuZq_uYOQk Idle-to-pistol animations], recorded by Loser
*[https://www.youtube.com/watch?v=6-ksW1bBBsg Mukade teleportation] by Iritscen
*Quantum tunnelling AI: [https://www.youtube.com/watch?v=oZZvMldrjlY the original incident], [https://www.youtube.com/watch?v=GC4HLDekxQI the same situation with logging], [https://www.youtube.com/watch?v=mTGv0Tu8z48 the same situation with showlinetochar], and [https://www.youtube.com/watch?v=zQgq8rqhPHA a final proof of the effect] by Iritscen and Loser
*[https://www.youtube.com/watch?v=dszw2vmlmzw Konoko's secret undress animation], recorded by Loser

===Modding mishaps===
*[https://www.youtube.com/watch?v=6pAIRSMr9y8 Magic bullet casings] by Loser
*[https://www.youtube.com/watch?v=WfhKwP7AL64 EdT discovers inside-out cars] by EdT

==Tributes and jokes==
*[https://www.youtube.com/watch?v=HFwnABhkGHo Oni Dancing] by EdT
*[https://www.youtube.com/watch?v=_XWmeZYlfEY Oni Police History] by AWPMega
*[https://www.youtube.com/watch?v=XoE3cBDOAhQ Griffin's Christmas] by Tantir1
*[https://www.youtube.com/watch?v=oOBl_6nDVG4 Come Here] Part I of the 3-part Oni Suite, a ridiculous tribute to Oni's voice acting by AaronPDX
*[https://www.youtube.com/watch?v=6v8DpJVusbk Recalibrate!] Part II of the 3-part Oni Suite, a ridiculous tribute to Oni's voice acting by AaronPDX
*[https://www.youtube.com/watch?v=H_FZCY-L6uc Oni's 10th Anniversary in Gmod] by Delano762
*[https://www.youtube.com/watch?v=ulGF6vCA7T0 Funny Oni] by ShinatamaCarmyKonoko
*[https://www.youtube.com/watch?v=OtrwzmlhqMo When Enemies Become Allies] by EdT
*[https://www.youtube.com/watch?v=Hqk8OlFsg7Y Oni Tribute - This is War] by Mukade and myplea
*[https://www.youtube.com/watch?v=uGugKhK3RI0 Places You Weren't Supposed To Go] by Samer
*[https://www.youtube.com/watch?v=8Ts8SGuxbK4 The Only Konoko, The Only Motoko] by vul4ak
*[https://www.youtube.com/watch?v=1Kj-Dmhu83Y Konoko learns from Gumby] by Gumby
*[https://www.youtube.com/watch?v=3oxfn11kRso Muro pursued] by Gumby

==Parkouring and music videos==
*[https://www.youtube.com/watch?v=WZdl5hyAA5E Oni parkour music video (Last of the Wilds - Nightwish)] by Loser
*[https://www.youtube.com/watch?v=hn5SzXaPHrE Oni gameplay music video (Clubbed to Death - Rob Dougan)] by unknown fan
*[https://www.youtube.com/watch?v=eQaU-I_bgUk Oni gameplay music video (No Tomorrow - Funker Vogt)] by unknown fan
*[https://www.youtube.com/watch?v=3ILprvjmrF4 Oni gameplay music video (The Thing I Hate - Stabbing Westward)] by vul4ak
*[https://www.youtube.com/watch?v=Cbvbpulnads Griffin parkouring near TCTF HQ during firefight] by EdT

==Oni in alternate engines==
*[https://www.youtube.com/watch?v=j0v-hZZ_ofk Oni In Half Life] by Maverick Jey-Kidding

==Oni 2 (Angel Studios)==
*[https://www.youtube.com/watch?v=ZItobLIJJMY Oni 2: Angel Studio's Lost Sequel to Bungie's Cult Classic] documentary by PtoPOnline
*[https://www.youtube.com/playlist?list=PLKywN7NE5TTE2fGdgdhYMs1cAQMD48Q-h Full playthrough] by Iritscen

[[Category:Media]]

Casey

2022-04-24T21:09:35Z

Samer:

[[Casey]] is the name given by the fandom to the enigmatic red-haired man who appears in the [[:Image:Intro_frame_0562.png|intro movie]], and on the fail screens of [[:Image:Act_1_.MISSION_FAILED.png|Act 1]] and [[:Image:Act_2_.MISSION_FAILED.png|Act 2]].
*[[Hardy LeBel]] [http://carnage.bungie.org/oniforum/oni.forum.pl?read=19649 stated] on the {{OCF}} that he might have been a love interest of [[Konoko]]'s in the storyline 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]] (a.k.a. andrashi), [[User:geyser|geyser]] came up with the family name "Shanahan". The idea was that he is of Irish descent. (Unlike Griffin)

;Playable character
*Casey was made into a playable character by [[User:Samer|Samer]], and was given various outfits, custom moves with custom sound, and a custom flying portrait. The mod can be discussed [http://oni.bungie.org/forum/viewtopic.php?id=1262 here]
[[Image:Casey_v6_5_outfits_1.png|1200px]]
[[Image:Casey_v6_5_outfits_2.png|1200px]]
[[Image:Casey_V6_Glow_Portrait.png|600px]]
*Prior developments of this character are due to Loser (a.k.a. andrashi) and geyser. They weren't as sophisticated as Samer's mod. [http://geyser.oni2.net/pics/screenshots/KONOKOandRED.jpg HERE] is an early screenshot.

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

File:Casey V6 Glow Portrait.png

2022-04-24T21:07:31Z

Samer: Category:Mod screenshots

== Summary ==
[[Category:Mod screenshots]]

File:Casey v6 5 outfits 2.png

2022-04-24T21:05:07Z

Samer: Category:Mod screenshots

== Summary ==
[[Category:Mod screenshots]]

File:Casey v6 5 outfits 1.png

2022-04-24T21:03:21Z

Samer: Category:Mod screenshots

== Summary ==
[[Category:Mod screenshots]]

File:DarkLitria - Shini3.png

2022-03-26T10:37:40Z

Samer:

[[Shinatama Bot]] Bionic (humane) outfit by DarkLitria

[[Category:Art by DarkLitria]][[Category:Fan art]]

Shinatama Evolved

2022-03-26T10:34:34Z

Samer:

'''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://oni.bungie.org/forum/viewtopic.php?id=1240 here]. The second outfit is based on DarkLitria's [[:Image:DarkLitria - Shini3.png|sketch]].

https://i.imgur.com/X9B9Rwa.png

[[Category:Modding projects]]

Videos

2022-03-10T17:33:51Z

Samer: adding new vids

Here is a collection of links to some of the Oni-related videos posted on YouTube. Also see YouTube's [https://www.youtube.com/channel/UCa3bHN9Pp4xrzWVtyIPiEZQ/recent Oni - Topic] channel, which automatically collects Oni videos (with some false positives from games/users that have similar names).

==Trailers==
:''See [[Trailers]] for details on the Bungie trailers.''
*[https://www.youtube.com/watch?v=ANQWWqECzI8 Bungie West's 1998 trailer]
*[https://www.youtube.com/watch?v=YLZ2hJZvrmo Bungie's 1999 trailer]
*[https://www.youtube.com/watch?v=kCUJmY7EZeo Oni trailer from Fall 2000 GoD Bonus CD]
*[https://www.youtube.com/watch?v=OmNtNzROvug Rockstar trailer]
*[https://www.youtube.com/watch?v=_cv8X2hc8YE Japanese trailer]

==Early footage==
*[https://www.youtube.com/watch?v=3vKJAZZWIxI Multiplayer at E3, May 1999]
*Multiplayer at Macworld NY, July 1999: [https://www.youtube.com/watch?v=iiBE8N1auuo], [https://www.youtube.com/watch?v=Z3u76geVaio]
*[https://www.youtube.com/watch?v=HOmKXhZJ3b8 Multiplayer at Macworld SF, Jan. 2000]
*Multiplayer at E3, May 2000: [https://www.youtube.com/watch?v=yFQNu-r4TOc], [https://www.youtube.com/watch?v=Sc8crcxjfgM], [https://www.youtube.com/watch?v=8Wp3xqAD4xw]
*[https://www.youtube.com/watch?v=xMJMQdkK9fs Electric Playground S4E7] (E3 coverage with brief Michael Evans interview from 03'47"–03'58")
*[https://www.youtube.com/watch?v=-FmGO67Q_vg Electric Playground S4E10] (Oni is featured from 00'26"–03'10")
*[https://www.youtube.com/watch?v=TaRjTYbUFNY Oni teaser at Macworld NY, July 2000]
*[https://www.youtube.com/watch?v=SO3JUw1dx3A Pre-beta PS2 footage]

==Documentaries and reviews==
*[https://www.youtube.com/watch?v=Yg1mfEvfq_k Oni - Trash or Treasure] by Block's Gaming Reviews*
*[https://www.youtube.com/watch?v=RJO4OB8xdQg Oni: The Other Bungie Game] by Critical Nobody
*[https://www.youtube.com/watch?v=jbrPu15jjPs Demon: The Untold Story of Bungie’s Forgotten Franchise] by CryMor Gaming
*[https://www.youtube.com/watch?v=jNgG8RSHNa8 Oni - Analytical Overview] by EonKool
*[https://www.youtube.com/watch?v=VOawPhCG2dU Gaming History: Oni "The other Best Game Bungie ever made"] by GaminGHD
*[https://www.youtube.com/watch?v=ggC6kfJJE_w Oni Review (Bungie's Forgotten Game)] by GmanLives
*[https://www.youtube.com/watch?v=_LRyxtXkPng Oni: The best Bungie game and its seven-years-late mod scene] by Joe Wintergreen
*[https://www.youtube.com/watch?v=7btzVHh_iXQ Review: Oni] by Nick H
*[https://www.youtube.com/watch?v=Ox6r7aJSRdU Top 10 Forgotten Video Games from Great Developers] by WatchMojo (Oni is #2)
*[https://www.youtube.com/watch?v=6hfFUlraIKQ Oni - Unlikely Review] by Yuusha*

<nowiki>*</nowiki>These reviews are of the PS2 version, and consequently much more negative.

==Intro and outro==
*[https://www.youtube.com/watch?v=du8JepLM-lI Oni Intro]
*[https://www.youtube.com/watch?v=Od1ReWIxduo Oni Outro]

==Gameplay==
*[https://www.youtube.com/watch?v=CDuQHITARk4 Some of Oni's Secrets and Easter Eggs] by Samer
*[https://www.youtube.com/watch?v=r06Q_hEhCg4 Science Prison Lasers] by Samer
*[https://www.youtube.com/watch?v=sSOLSh_aCC8 Grenade Jumping] by loveOni shows how to get to those snipers in Chapter 14 using an SBG
*[https://www.youtube.com/playlist?list=PLFa3CejQbQ2IAihiuD58DLPUraoSccuOt Oni AE Full Levels Gameplay (using several mods)] by Tracker
*[https://www.youtube.com/playlist?list=PLFasmrd0ZfRm80eHfK3g_eDAXJWb0PM5I Oni Let's Play (using Brutal AI, SMP-Conversion, and other mods)] by tens
*[https://www.youtube.com/watch?v=N5dU4IdKlXQ Chasing Mukade] by Loser

==Mods==
===Anniversary Edition===
*[https://www.youtube.com/watch?v=Il46o_ahOds&list=FLtTcOh2t7wRZ5rXzMmWt6xA&index=4 Russian Video showcasing many of the AE mods] by mainfram812
*[https://youtube.com/playlist?list=PL_MVvdrljWSR6pnE6zcIByVoasbDBugT0 Oni Playlist featuring many videos using the AE and different level and character mods] by John Thunder

===Characters===
*[https://www.youtube.com/watch?v=Sntev0Gj5Ds Custom Character Casey version 4 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=RbfE6k2ulW4 Custom Character Motoko version 3.5 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=ldVEmOV839U Custom Character BGI Sarai demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=KYgNmpLED5M Custom Character Hayate version 2.1 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=Ci44KaCq7UY Custom Characters Jester & Co. demonstrating all moves and combos] by Samer
*[https://www.youtube.com/watch?v=5R8zuI5-EHw Custom Character Kojiro version 2.2 demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=9VlUBaQWuXg Custom Character BGI Hammer demonstrating all moves, combos and outfits] by Samer
*[https://www.youtube.com/watch?v=YtRac64hu6Q Custom Character Rayman Showcase] by Samer
*[https://www.youtube.com/watch?v=NSfeb4xv7p8 Konoko vs. AI Rayman] by Samer
*[https://www.youtube.com/watch?v=4-P82ctyS2E Guard Dogs preview] by EdT
*[https://www.youtube.com/watch?v=iLl9FAoujIs Sentry Droid preview] by EdT
*[https://www.youtube.com/watch?v=yhkTFgEyj28 The Iron Demon Lives] by EdT
*[https://www.youtube.com/watch?v=5whksLNIVmA Iron Demon walking] by EdT
*[https://www.youtube.com/watch?v=I4OCptczD0Q Iron Demon explosion effect] by Loser
*[https://www.youtube.com/watch?v=d2opg2DIGwk Golden TCTF vs. Regenerating Tanker] by Samer
*[https://www.youtube.com/watch?v=MmurRBUbW-U Clash of Titans - BGI Hammer vs. Barabas] by Samer
*[https://www.youtube.com/watch?v=M0ugC6fV-6o Hayate vs. Jester, Casey vs. Hayate, Jester vs. Jubei & Akane] by Samer
*[https://www.youtube.com/watch?v=w-5c5lHjCGA Akane vs. Grey Fury, Jubei vs. Kojiro] by Samer
*[https://www.youtube.com/watch?v=o7NvGBsT-gI Casey combo video in Oni Zen Garden] by Samer
*[https://www.youtube.com/watch?v=vR7Z0Wcuuso Akane combo video in Oni Zen Garden] by Mukade
*[https://www.youtube.com/watch?v=yD6Ai8uufJI Altered Barabas Boss Fight] by Loser (Mod can be found in EdT's Boss Battle Level)
*[https://www.youtube.com/watch?v=QaBDJk9KrNs Barabas New Regeneration] by Gumby
*[https://www.youtube.com/watch?v=ASyyzfIc3D0 Shinibot & Hanako vs. Smart Barabas] by Samer
*[https://www.youtube.com/watch?v=WQZSY8cmj9k Kojiro & Casey vs. Smart Barabas] by Samer
*[https://www.youtube.com/watch?v=kbA4JvcBZFQ Konoko vs. Smart Barabas] by Samer
*[https://www.youtube.com/watch?v=-4Dt_7AmdK0 Konoko vs. Smart Barabas with Jumpable Earthquaker package] by Samer
*[https://www.youtube.com/watch?v=LNUcS_mtHpA Jubei pathfinds] by Gumby & geyser
*[https://www.youtube.com/watch?v=EZ3bai7BhR4 Shapeshifting Montage] by Paradox

===Levels===
*[https://www.youtube.com/watch?v=dtmPmt6YqEE Oni goes to a new Level] by EdT
*[https://www.youtube.com/watch?v=DyOIcie7VGk Omega Tournament Level Preview] by Script10k
*[https://www.youtube.com/playlist?list=PLZQupCr62BGlWdKfx6QV-jArcjDgU64Fs Wilderness Preserve Level Full Walkthrough] by Samer
*[https://www.youtube.com/watch?v=MArbspInwiM SamMegaPack-Fight Club Level Preview] by Samer
*[https://www.youtube.com/watch?v=hg_7FMlyo9M China Level Mod Final Battle] by Script10k
*[https://www.youtube.com/watch?v=CChvV7GTi28 Hanako vs. Hayate and Mukade in China Level Mod] & [https://www.youtube.com/watch?v=CChvV7GTi28 Hanako in Final Battle of China Level] by Samer
*[https://www.youtube.com/watch?v=WZ26KJ46CzE Fight Over the Junkyard] by EdT
*[https://www.youtube.com/watch?v=Wv1IG6QXTMs Oni Custom Characters Good vs. Bad in Junkyard Level] by Samer
*[https://www.youtube.com/watch?v=iKXw5jt3vSE EdT's City Level Parkour Challenge] by Samer
*[https://www.youtube.com/watch?v=QwRzyBGK1yk Oni Tomb Raider Style] showcasing EdT's Parkour Challenge 1 Level by Samer
*[https://www.youtube.com/watch?v=PR_0gddHkNA Parkour Challenge 2 Run] by Tracker
*[https://www.youtube.com/watch?v=GUR66F9rISE SamMegaPack-Conversion Preview] by Samer
*[https://www.youtube.com/watch?v=wwqQHXvCgeQ SamMegaPack-Conversion Final Battle Spared Griffin Version] by Samer
*[https://www.youtube.com/watch?v=e97TCEPhjK0 SamMegaPack-Conversion Final Battle Killed Griffin Version] by Samer
*[https://www.youtube.com/watch?v=Bs8rdGyEpog SamMegaPack-Conversion Dream Lab Preview] by Samer
*[https://www.youtube.com/watch?v=oHCnoThNL2c SamMegaPack-Conversion Skull Team (renamed to Saisei Team) Fights Preview]
*[https://www.youtube.com/watch?v=tE3ZfKzZnOM SamMegaPack-Conversion Atmospheric Interior, Konoko vs Grey Fury] by Samer
*[https://www.youtube.com/watch?v=MIhyHi-C2dY Motoko in Leus' Crazy Casey Mod] by Shella45
*[https://www.youtube.com/watch?v=5PClAPTum8w Leus' Crazy Casey Mod in reverse] by kaargen

===Weapons===
*[https://www.youtube.com/watch?v=9kJF7HSJl04 New Weapons Collection preview] by Samer
*[https://www.youtube.com/watch?v=vrvQjvV0OUA Sniper Mode] by Paradox, demoed by EdT
*Fun with TK Bracelet: [https://www.youtube.com/watch?v=3dE65ZViFl0], [https://www.youtube.com/watch?v=uptSCVabiBY], [https://www.youtube.com/watch?v=OBWUfHlND9Y] by Iritscen
*[https://www.youtube.com/watch?v=1WuMd_fhWbo Phaser rifle demo] by ONIrules

===Animations===
*[https://www.youtube.com/watch?v=tE1xO5K3hi8 New combat Moves for Konoko] showcases new move types like Just Frames and Delayed Animations by Delano762
*[https://www.youtube.com/watch?v=Sbz-3pauSlM Ninja Shadow Dash mod] by Gumby
*[https://www.youtube.com/watch?v=PzMx6SED9gA Prone Mode Revisited] by Paradox
*[https://www.youtube.com/watch?v=hpmqiel9vfQ Barabas using jetpack in Airport Cargo Hangars] by Loser
*[https://www.youtube.com/watch?v=aiN8vmEtvv8 Disarm Revamp demo] by Loser
*[https://www.youtube.com/watch?v=BYYm5AAdpjs Domino Knockdowns demo] by Loser
*[https://www.youtube.com/watch?v=aIbQ1B4pSfM Hit_jewels for females demo] by Loser
*Head2Wall system: [https://www.youtube.com/watch?v=VUM8T06dcn8], [https://www.youtube.com/watch?v=K9c4l8TpTB8], [https://www.youtube.com/watch?v=dCRGTgeFms0]

===Vehicles===
*[https://www.youtube.com/watch?v=5tK9VwQrcp4 Lamborghini Countach rams TCTF HQ] by Iritscen

===Other mods===
*Flatline multiplayer footage: [https://www.youtube.com/watch?v=WZnbVGSyRJU Gumby vs. oxe161], [https://www.youtube.com/watch?v=GMeWr11QVjU Gumby vs. Phydur]
*[https://www.youtube.com/watch?v=aEuAu7jLQQI Projectile dodging patch for AI]
*[https://www.youtube.com/watch?v=RjGgk6SqdeQ Things that go boom] by EdT
*[https://www.youtube.com/watch?v=fec1-bgfCxE Japanese Language Pack special attacks preview] by Gumby
*[https://www.youtube.com/watch?v=bib24bRXuhQ Hidden Treasure Challenge] by Samer
*Good vs. Evil 2.0: [https://www.youtube.com/watch?v=CKhHaG_t0eg video 1], [https://www.youtube.com/watch?v=lzB0I-eeO9o video 2], [https://www.youtube.com/watch?v=dcuF1ABj9D0 video 3] by Iritscen
*[https://www.youtube.com/watch?v=gOHCg8KZM4A Burly Brawl v0.1] by Iritscen
*[https://www.youtube.com/watch?v=zacLylPPTFk Every man for himself on ACC pillar] by EdT
*[https://www.youtube.com/watch?v=-6I78-N_2Yo Fighting Multiple Mukades is Hard] scripted by Loser, demoed by Iritscen
*[https://www.youtube.com/watch?v=TQ8n1oIUW-I Three-Dee Shells vs. Original Shells] by Loser and Iritscen

===Concepts===
*[https://www.youtube.com/watch?v=GFbamj63z8Y AI pathfinding in new level] by EdT
*[https://www.youtube.com/watch?v=Yj3ptZnZtx0 AI pathfinding on uneven ground] by EdT
*[https://www.youtube.com/watch?v=Em6wa5JTQNM Hiding parts of the environment] by EdT
*[https://www.youtube.com/watch?v=iY0eKukGhrM AI Crate jumping] by EdT
*[https://www.youtube.com/watch?v=2RU6asmmrik New animations - Motoko the cheerleader] by EdT
*Playing with moveable objects: [https://www.youtube.com/watch?v=Te9yKA4UR18 cubes], [https://www.youtube.com/watch?v=LUmmLTjSaqQ spheres] by Iritscen
*[https://www.youtube.com/watch?v=YICB7qugrtc Moveable furniture] by EdT
*[https://www.youtube.com/watch?v=ogT1QUblCxc Deadly Van de Graaff Pistol] by Gumby
*[https://www.youtube.com/watch?v=16LqQCPvo2Q Gumby's Death Ray 1] by Gumby
*[https://www.youtube.com/watch?v=bHOMtGDKGSk Gumby's Death Ray 2] by Gumby
*[https://www.youtube.com/watch?v=qccsevDKve0 Dynamic shadow test] by Gumby
*[https://www.youtube.com/watch?v=WzMkNXtfefA Stenciling test] by Gumby
*[https://www.youtube.com/watch?v=VHr7g94sBzE Konoko Regeneration] by Paradox
*[https://www.youtube.com/watch?v=_-o4hMQQU7k AI can intercept player] by Loser
*[https://www.youtube.com/watch?v=eXL9o49I_g0 AI can use Twister Kick and Willow Kick] by Loser
*[https://www.youtube.com/watch?v=CkzguNxjGEs AI Konoko plays Chapter 1 of Oni] by Loser
*[https://www.youtube.com/watch?v=6oTbT6qkcg0 AI has sense of touch, can recognize fallen allies] by Loser
*[https://www.youtube.com/watch?v=pORGOquI_XE Alarm logic demo] by Loser
*[https://www.youtube.com/watch?v=Zgg0fsTs1DU Counter-attack based on Willow Kick] by Loser
*[https://www.youtube.com/watch?v=_n-8SwG_DJk Faster thrower recovery] by Loser
*[https://www.youtube.com/watch?v=ESR_6bgl1dA Female kneegrab demo] by Loser
*[https://www.youtube.com/watch?v=ywk_A6bNHpY Multi-hit Striker Slam] by Loser
*[https://www.youtube.com/watch?v=NQE-LjM9GqM Mukade's Glory] by Loser (the famous pathfinding Mukade video)
*[https://www.youtube.com/watch?v=nlzTajiyl24 Forward knockdown test] by Loser
*Active blocking demos: [https://www.youtube.com/watch?v=EGTwej4nQTM Using timed press of block key], [https://www.youtube.com/watch?v=IKsPMGSomi8 Holding block key] by Loser
*[https://www.youtube.com/watch?v=_7dDjiMnUlw Revised melee collision reactions demo] by Loser
*[https://www.youtube.com/watch?v=zPNINENGLDc Sword animation candidates] by Loser
*[https://www.youtube.com/watch?v=hlQ_JLUI4BA Stun-to-throw demo] by Loser
*[https://www.youtube.com/watch?v=LXiK6rzfMSU Throw-canceling demo] by Loser
*[https://www.youtube.com/watch?v=8ajDTkYPuuM Vulnerable throw victims demo] by Loser
*[https://www.youtube.com/watch?v=lMGpDFNO9m8 Successful railing throws] by Loser

==Modding tutorials==
*[https://www.youtube.com/watch?v=7fQacrVVQLc&list=PLBKEEq8F3prAbbGk6VJkjfLMuMnb-e_gu Creating a Custom Oni Level: Tutorial on building the Omega Tournament Level] by Script10k
*Paradox's Mod Tool tutorials: [https://www.youtube.com/watch?v=CFNseg_2UxA A simple animated object], [https://www.youtube.com/watch?v=w1hLbZPwd2Q Camera interpolation and animation], [https://www.youtube.com/watch?v=yYHaltepyNI CRSA import], [https://www.youtube.com/watch?v=oCo2u8XxVd0 Merging character objects, no FBX required]
*[https://www.youtube.com/watch?v=vDTPYfvMf4M Creating forward throws for Oni with the help of Excel] by Paradox

==Bugs and quirks==
===Vanilla content===
*[https://www.youtube.com/watch?v=0onq6m7oius Infinite loop bug]
*[https://www.youtube.com/watch?v=qbo2Q-VD6dc Idle animations] & [https://www.youtube.com/watch?v=CRuZq_uYOQk Idle-to-pistol animations], recorded by Loser
*[https://www.youtube.com/watch?v=6-ksW1bBBsg Mukade teleportation] by Iritscen
*Quantum tunnelling AI: [https://www.youtube.com/watch?v=oZZvMldrjlY the original incident], [https://www.youtube.com/watch?v=GC4HLDekxQI the same situation with logging], [https://www.youtube.com/watch?v=mTGv0Tu8z48 the same situation with showlinetochar], and [https://www.youtube.com/watch?v=zQgq8rqhPHA a final proof of the effect] by Iritscen and Loser
*[https://www.youtube.com/watch?v=dszw2vmlmzw Konoko's secret undress animation], recorded by Loser

===Modding mishaps===
*[https://www.youtube.com/watch?v=6pAIRSMr9y8 Magic bullet casings] by Loser
*[https://www.youtube.com/watch?v=WfhKwP7AL64 EdT discovers inside-out cars] by EdT

==Tributes and jokes==
*[https://www.youtube.com/watch?v=HFwnABhkGHo Oni Dancing] by EdT
*[https://www.youtube.com/watch?v=_XWmeZYlfEY Oni Police History] by AWPMega
*[https://www.youtube.com/watch?v=XoE3cBDOAhQ Griffin's Christmas] by Tantir1
*[https://www.youtube.com/watch?v=oOBl_6nDVG4 Come Here] Part I of the 3-part Oni Suite, a ridiculous tribute to Oni's voice acting by AaronPDX
*[https://www.youtube.com/watch?v=6v8DpJVusbk Recalibrate!] Part II of the 3-part Oni Suite, a ridiculous tribute to Oni's voice acting by AaronPDX
*[https://www.youtube.com/watch?v=H_FZCY-L6uc Oni's 10th Anniversary in Gmod] by Delano762
*[https://www.youtube.com/watch?v=ulGF6vCA7T0 Funny Oni] by ShinatamaCarmyKonoko
*[https://www.youtube.com/watch?v=OtrwzmlhqMo When Enemies Become Allies] by EdT
*[https://www.youtube.com/watch?v=Hqk8OlFsg7Y Oni Tribute - This is War] by Mukade and myplea
*[https://www.youtube.com/watch?v=uGugKhK3RI0 Places You Weren't Supposed To Go] by Samer
*[https://www.youtube.com/watch?v=8Ts8SGuxbK4 The Only Konoko, The Only Motoko] by vul4ak
*[https://www.youtube.com/watch?v=1Kj-Dmhu83Y Konoko learns from Gumby] by Gumby
*[https://www.youtube.com/watch?v=3oxfn11kRso Muro pursued] by Gumby

==Parkouring and music videos==
*[https://www.youtube.com/watch?v=WZdl5hyAA5E Oni parkour music video (Last of the Wilds - Nightwish)] by Loser
*[https://www.youtube.com/watch?v=hn5SzXaPHrE Oni gameplay music video (Clubbed to Death - Rob Dougan)] by unknown fan
*[https://www.youtube.com/watch?v=eQaU-I_bgUk Oni gameplay music video (No Tomorrow - Funker Vogt)] by unknown fan
*[https://www.youtube.com/watch?v=3ILprvjmrF4 Oni gameplay music video (The Thing I Hate - Stabbing Westward)] by vul4ak
*[https://www.youtube.com/watch?v=Cbvbpulnads Griffin parkouring near TCTF HQ during firefight] by EdT

==Oni in alternate engines==
*[https://www.youtube.com/watch?v=j0v-hZZ_ofk Oni In Half Life] by Maverick Jey-Kidding

==Oni 2 (Angel Studios)==
*[https://www.youtube.com/watch?v=ZItobLIJJMY Oni 2: Angel Studio's Lost Sequel to Bungie's Cult Classic] documentary by PtoPOnline
*[https://www.youtube.com/playlist?list=PLKywN7NE5TTE2fGdgdhYMs1cAQMD48Q-h Full playthrough] by Iritscen

[[Category:Media]]

Casey

2020-07-01T14:52:51Z

Samer:

[[Casey]] is the name given by the fandom to the enigmatic red-haired man who appears in the [[:Image:Intro_frame_0562.png|intro movie]], and on the fail screens of [[:Image:Act_1_.MISSION_FAILED.png|Act 1]] and [[:Image:Act_2_.MISSION_FAILED.png|Act 2]].
*[[Hardy LeBel]] [http://carnage.bungie.org/oniforum/oni.forum.pl?read=19649 stated] on the {{OCF}} that he might have been a love interest of [[Konoko]]'s in the storyline 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]] (a.k.a. andrashi), [[User:geyser|geyser]] came up with the family name "Shanahan". The idea was that he is of Irish descent. (Unlike Griffin)

;Playable character
*Casey was made into a playable character by [[User:Samer|Samer]], and was given various outfits, custom moves with custom sound, and a custom flying portrait. The mod can be discussed [http://oni.bungie.org/community/forum/viewtopic.php?id=1262 here]
[[File:Casey mod outfits.png|1200px]]
*Prior developments of this character are due to Loser (a.k.a. andrashi) and geyser. They weren't as sophisticated as Samer's mod. [http://geyser.oni2.net/pics/screenshots/KONOKOandRED.jpg HERE] is an early screenshot.

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

Casey

2020-07-01T14:52:01Z

Samer:

[[Casey]] is the name given by the fandom to the enigmatic red-haired man who appears in the [[:Image:Intro_frame_0562.png|intro movie]], and on the fail screens of [[:Image:Act_1_.MISSION_FAILED.png|Act 1]] and [[:Image:Act_2_.MISSION_FAILED.png|Act 2]].
*[[Hardy LeBel]] [http://carnage.bungie.org/oniforum/oni.forum.pl?read=19649 stated] on the {{OCF}} that he might have been a love interest of [[Konoko]]'s in the storyline 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]] (a.k.a. andrashi), [[User:geyser|geyser]] came up with the family name "Shanahan". The idea was that he is of Irish descent. (Unlike Griffin)

;Playable character
*Casey was made into a playable character by [[User:Samer|Samer]], and was given custom moves and various outfits. The mod can be discussed [http://oni.bungie.org/community/forum/viewtopic.php?id=1262 here]
[[File:Casey mod outfits.png|1200px]]
*Prior developments of this character are due to Loser (a.k.a. andrashi) and geyser. They weren't as sophisticated as Samer's mod. [http://geyser.oni2.net/pics/screenshots/KONOKOandRED.jpg HERE] is an early screenshot.

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

File:Casey mod outfits.png

2020-07-01T14:48:38Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

XML:TRAM

2020-06-28T15:45:31Z

Samer:

{{XML_File_Header | type=TRAM | prev=TRAC | next=TRAS | name=Totoro Animation }}

{{TOCfloat|side=right}}

TRAM files - animation data for characters - are basically made of three chunks.

* Meta data or "header": animation type, state, flags, particle, sounds, etc.
* Animation data: pelvis heights, pelvis velocities, bone rotations
* Attack data: damage, self-damage, extends (danger zones for AI awareness) and throws

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.

===Decision path of animation lookup===
* At 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 child TRAC override those of the parent if their combination of state, type and variant is excatly the same.
* On the other hand child TRAC often miss some anims. For example elite striker don't have their own run anims, they must and will use the parent anims of normal strikers. The game was here designed to save resources. See [[XML:TRAC|TRAC]] page for details.
* A character possesses always one 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 played at a given moment.
* It follows the full decision path:
** anim '''state''' check
** event (user input / engine input for AI) -> [[XML_talk:StNA|context check]] -> anim '''type''' check
** anim '''variant''' check
** TRAC '''weight''' check

One detailed example:

Let's say we shapeshifted to an ninja ONCC, are in state Standing and hit the action key for taunt.

The engine recognizes the context (an hostile character to interact with) and looks up anims of type Taunt.

Since we are in combat mode the following anim must be of variant Combat if possible.

Those lookups all boile down to two valid anims, NINCOMtaunt1 and NINCOMtaunt2.

If there are multiple anims avaible at this point the engine has to pick one of them randomly.

However, NINCOMtaunt1 has a TRAC Weight (probability) of 100 while NINCOMtaunt2 has a TRAC Weight value is just 5.

Chances are quite high we will not see the Moon Walk taunt.

Keep in mind that if the engine cannot find an anim of a specific variant it will fall back to use the non-variant anim instead.

Confused how Weights work? Apparently, that Weight value is only one part of the equation - otherwise NINCOMtaunt2 would never execute.

If there is only one anim to chose from, it will always play no matter what Weight, even if it is zero.

As for multiple anim being a valid choice the calculation seems to be this for an individual anim: weight / sum of all weight.

For NINCOMtaunt2 it means 5 / 105 = 0,047 (4,7%).

===List of tags, types, and flags===
Use the search function of your web 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]]. Pool of valid TRAM (animations a character can chose from) is build from TRAC files registered in ONCC. Most of the anim types are associated with player inputs.
|-
| <AimingType>
| flag
| Look them up over [[XML:StNA#animation_types|HERE]]. Pool of valid TRAM, and therefor TRAS, (animations a character can chose from) is build from TRSC files registered in 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, tag will be simply "<Varient />", such as for non-combat animations. Otherwise 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 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 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 8 frames long; 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 with rotations are less noticeable, interpolations of different positions can cause an additional drift (i.e. sliding).

This was especially observed for transitions of 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 better don't use interpolation. Just let the start and end frames have same positions and rotation values as the idle. Interpolations should always be considered as ''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 single 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 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
|
: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. Damage from particles and fall damage still hurt.
:BlockHigh
::While playing this animation, the player is invulnerable to high or undefined attacks within some arc in front of him. 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 attacks.
:Attack
::Animations with an attack part have this turned on. Uncertain what it does, but it may enable the melee soft-lock (where the character turns a bit during the animation to face a nearby enemy).
:DropWeapon
::If the player is armed, he drops his weapon when this animation plays.
:InAir
::Something to do with jumps; not investigated.
:Atomic
::The whole animation must be played; player cannot interrupt it once it starts.
:NoTurn
:::Player cannot turn by mouse while performing this animation.
:AttackForward
::Unknown, but it looks like this is rough info for the AI about where an attack is aiming, from the player's point of view.
: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
::Unknown, but throws use it.
: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 the hurt 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
::It appears this flag was used 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 them 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
::Unknown.
:DisableShield
::If the player has an active supershield (chr_super "name" 1), this forces him to disable it (chr_super "name" 0)
:NoAIPickup
::AIs are not permitted to pick up items with this animation.
|-
| <Atomic>
| parent tag
| 
|-
| <Start>
| int16
|
|-
| <End>
| int16
|
|-
| <Invulnerable>
| parent tag
| Character will not take melee damge during a timeframe defined by 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
|
|-
|valign="top"| <Soft>
|valign="top"| int16
| Player cannot make new inputs during this pause unless this animation is followed by a followup combo animation defined by <DirectAnimations><Link>.
: Examples:
: COMcomb_p, (no pause) COMcomb_p_p
: COMcomb_p, (pause) COMcomb_k
Combos ignore <Interpolation><End>.
|-
| <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)

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 accelerationsat start and end. By default, animations without specified Shortcut interpolation give about 8 frames of interpolation. For moves starting or ending in idle better don't use interpolation. Just let the start and end frames have same positions and rotation values as the idle. Interpolations should always be considered as ''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 animation 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"|
|
:None
:Forward
:Backward
:Left
:Right
|-
| <Vocalization>
| int
| Id of one of the [[XML:SNDD#step_1:_preparing_the_TRAM|SoundConstances in ONCC]]
|-
| <ActionFrame>
| int
| Frame number for spacial events associated with this animation: weapon theft in disarms, weapon holster, Mukade actually teleporting, items getting handed over to player. "Give me that hypo!" Yada yada.
|-
| <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 number exceeds frame count of animation the particle will simply die with end of 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
|
|-
| <End>
| int16
|
|-
| <Lifetime>
| int8
|
|-
| <Alpha>
| int8
|
|-
| <Interval>
| int8
|
|-
| <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 only the change of 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 those has no effect in game.'''
|-
| <X>
| int16
|
|-
| <Z>
| int16
|
|-
| <Positions>
| parent tag
|
|-
| <Position>
| float
| seems to be unused (also 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:
*X - Side axis. Negative values move the target to the right, positive values move the target to the left.
*Y - Height axis. Negative values move the target downwards, but in case of collision due to too low negative value, it will not make the target go below the surface. Positive values make the target go upwards - if the value is too big, the target will teleport above, and then immediately start falling, interrupting the target animation.
*Z - Forward axis. Negative values move the target backwards, positive values move the target forward.
|-
| <Angle>
| float
|
|-
| <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 parent TRAC.
|-
|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" can also be omitted)
|-
| <SelfDamage>
| parent tag
| "<SelfDamage />" if unused.
|-
| <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 [http://oni.bungie.org/community/forum/viewtopic.php?pid=39787#p39787 hit by both of them].
|-
| <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
|
: Unblockable
: Low - Target of attack needs to crouch in order to block this attack.
: High - Blocker needs to stand; if Low and High are set then blocker can block from both standing and crouching positions.
: HalfDamage - Blocker receives half of the normal damage.
|-
| <Knockback>
| float
| Target gets "knockback"ed by this amount.
|-
| <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 for how long the target should remain in his "hit" animation state when he gets hit.
|-
| <StunLength>
| int16
| Number in frames for how long the target should remain in his blocking animation when he blocks the attack.
|-
| <StaggerLength>
| int16
| Number of frames for how long 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 XML.
|-
| <Extent>
| parent tag
| One tag per frame.
|-
| <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 so that the AI has a chance 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]]

When you start '''[[Vago_(tool)|Vago]]''', the "General" tab should be open by default. If not, click on it. Then follow these five easy steps.


'''Step 1:''' Select "ONI" as input format ("From").

'''Step 2:''' Select "XML" as output format ("To").

'''Step 3:''' Check "Another TRAM" to chose a character animation file.

'''Step 4:''' Click "Add" button to choose an ONCC file.

'''Step 5:''' 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 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===
====XSI====
You can load the DAE file into a compatible editor. So far, the community's favorite is {{ModTool}}.
* 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 is also intended for the animations. This makes sure the pelvis height will match and feet will not float in the air or go through the ground.
* First frame and last frame 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 been 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 [[wikipedia:Gimbal_lock|gimbal lock]].

See also our [http://oni.bungie.org/forum/viewtopic.php?id=1433 OCF thread].

====Blender====
Theoretical possible. Very difficult in practice and we don't have a tutorial on this one.

===Import===
onisplit -create output_path path_to\TRAMname.xml

==Additional details==

===Existing TRAMS===
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.]]

===Speeding up existing animations===
s10k has created a XmlTools patch that allow the speedup of any existing TRAM (by removing frames). More information and download [http://mods.oni2.net/node/354 here.]

===Attacks===
====Extents and XML====
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> minimal 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 (again, see the MELE page).
::The number of <Extent>s is equal to the number of attack frames: <End> minus <Start> plus one (because start frame counts too). For example, for TRAMKONCOMkick_low1: <End>30</End> minus <Start>22</Start> plus one = 9 <Extent>s.

:These extents are pretty impossible to guess, so leave them alone until Neo comes up with extent computation (probably from attack bones and bone rotations). However, always add at least one set of component tags, because those Length, MinY and MaxY components will be taken as the longest extent, the highest Y value, and the lowest Y value. Without those, a character won't react to this attack.

*'''<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.

====Adding extents to an existing animation====
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 representative size for 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 keystroke or mouse clicks for combos is hardcoded.

To assign an animation for a specific combo attack you set corresponding value in <Lookup><Type>.

Setting a value in <Link> of '''<DirectAnimations>''' will do two things:
# It will increase the time for player input, meaning the next animation can be executed more easily. (In vanilla 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 combos===
For short '''JF combos''' or '''JF anims'''. Created by Delano, inspired by the game series Tekken.

JF means you have to press certain keys (w + k or w + p) at the exact time, which is more difficult than it might sound.

Package 54000 has basically a collection of new state cycles.

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

===Throws===
Throw target animations are registered in the TRAC of the throw initiator (AKA the throw source). Target animations are forced onto the other character, removing the need to have that animation in the target's TRAC. Throw target (TRAM*tgt) animations can cover only up to 256 (0-255) frames.

====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.

=====Excel macro=====
Needs update.

[[Image:Animation_macro_v4.png|right|thumb]]
* [http://dl.dropbox.com/u/139715/OniGalore/TRAM_macro.zip Here's the macro] (for all TRAMs except overlays). [http://youtu.be/wxzJ8ahjP8k Demo vid here]. Usage:
* Put your files into the "input_and_output" folder.
* Disable macro security if you don't want to have to click on the macro options button every time.
* Close other worksheets before you run the macro.
* If you are not afraid of VBA code, you can enter the dev environment by hitting Alt+F11. If you want to extend the attack library with more screenshots and settings, search for: "LibraryThrows", " LibraryAttack", "Picture", and "CBAttackHelp.AddItem".

===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. These could be reintegrated/recycled/whatever....

'''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 was placing something (bomb?) and then running away
* KONOKOlev4_undress: from an aborted clothes-changing cutscene
* KONOKOlev16_bomb: planting a bomb
* KONCOMsuper_kick: now used in OTA scripts (mod) as spawn event, and by custom made character [[Shinatama Bot]]
* KONCOMsuper_punch: KONCOMpunch_heavy but without the shouted attack name, has HalfDamage flag, and does 10 less damage in its first attack part
* 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: Striker checking his his gun and communicating with an ally (another unused alertness animation)
* THUGlev1_direct: Thug probably directing a truck driver

'''From modders'''

[[Image:female_stun.jpg|right|thumb|charA and charB 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

===FX - special effects===
If the scene is overloaded by particle - including motion blur - these effects will stop to be rendered.

So, don't overuse effects.

====Adding colorful 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====
...

{{XML}}

BSL:BFW Scripting Language

2020-06-28T04:38:52Z

Samer:

'''[[Modding_Oni#Introduction_to_the_Oni_engine|BFW]] Scripting Language''' (simply called '''BSL''') is what Oni scripts are written in. Being a scripting language, it is far more limited in scope and usage than a "real" programming language, as it was designed only to move events forward in the game, not to build programs. More specifically, BSL scripts are responsible for managing the player's objectives, directing AIs, creating environmental effects, and driving cutscenes.

Physically speaking, they are the .bsl files inside the [[IGMD|Oni/GameDataFolder/IGMD/]] folder. Being in plain-text, scripts can be edited with any word-processing program, such as the built-in Notepad (Windows) or TextEdit (Mac); the only requirement is that you must use the suffix ".bsl" for scripts instead of ".txt" (in Windows, you may have to turn on the displaying of file extensions to see the suffix).
__NOTOC__
==Getting started==
*You may wish to first read either the "Introduction" or the "Manual" page under "Knowledge database" below.
*To learn BSL by example, you can read the .bsl files in Oni's IGMD folder or look at the "Scripted mods" section below, and draw connections between the scripting commands and the resulting events in the game.
*For a primer in writing BSL, see the "Tutorials" section below.
*For a list of known bugs (and fixes/workarounds when available), see [[BSL:Bugs|HERE]].

==Scripted mods==
Scripted mods are great examples of what can be achieved simply by editing text files. They replace or add to Oni's .bsl files to spice up the gameplay and provide a more exciting experience to those who have finished the game. However, they can only change the way that game data is used; adding new characters or changing the layout of a level, for instance, would require editing the actual [[OBD|game data]]. When new levels are created for Oni, these naturally require new scripts to be written from scratch to take advantage of the new game assets.

One ambitious example of a scripted mod is [[AE:OTA|Oni Team Arena]]. Based on the desire for a [[multiplayer]] mode in Oni, and inspired by Unreal Tournament, OTA augments Oni's hand-to-hand combat and gunplay with a scoring system much like Unreal Tournament's Deathmatch mode. Other scripted mods range from free-for-all arenas to objective-based missions and enhancements of the original levels. Scripted mods can be found [http://mods.oni2.net/mods/Script here], [http://your-mom.oni2.net/Downloads.htm here] and [[User:Script_10k#Minor_Scripts|here]]. New levels, with their own BSL files, can be found [http://mods.oni2.net/mods/New%20Level here] (mod packages found on the Mod Depot are meant to be installed through the [[AE]]).

==Tutorials==
;[[BSL:Tutorial/Console|Playing with the developer console]]
:The fastest way to start learning BSL is to just load the first level and open the dev console.

;[[BSL:Tutorial/Modification|Original logic modification]]
:There are lots of cool things to do by merely looking at the original scripts and changing a few parameters.

;[[IGMD/global|Patching]]
:Want to script a "patch" that's effective in every level?

;[[BSL:Tutorial/Scratch|New logic from scratch]]
:Create completely new level logic from scratch.

==Knowledge database==
*[[BSL:Introduction|Introduction]] (a quick reference, ideal for those with programming experience)
*[[BSL:Manual|Manual]] (the complete reference on BSL, with more details and explanations for newbies)
*[[:Category:Scripting tasks|Scripting commands grouped by subject]] (work in progress)
*[[BSL:List|List of all scripting commands]] (work in progress)
*[[IGMD|File documentation for game scripts]]
*[[BSL:Snippets|Useful snippets of BSL]]
*[[BSL:Functions]], [[BSL: Variables]] Lists of all BSL functions and variables and what they do.
* References of in-game IDs of [http://ssg.oni2.net/subfold/charas/charas.htm Characters], [http://ssg.oni2.net/subfold/consoles/consoles.htm Consoles], and [http://ssg.oni2.net/subfold/doors/doors.htm Doors], which can be manipulated by scripts.

[[Category:BSL docs]]

BSL:BFW Scripting Language

2020-06-28T04:29:55Z

Samer:

BSL:Variables

2020-06-28T04:17:19Z

Samer:

'''Variables''' in BSL are very similar to variables in other programming languages. Here's a brief explanation of what a variable is:

When writing logical programs, one often needs the program to remember some information (a number, a piece of text, the ON/OFF state of a switch, etc) so that the information can be used at a later time.

The usual thing to do in this situation is to store the needed data in a '''variable''': an elementary data container.

==General notions==
===Type and value===
A variable (data container) has three important attributes: the ''name'', the ''type'' and the ''value''.

The ''value'' or the variable is just the contents it currently stores. It can be read and written.

Also, a given variable can store only a specific ''type'' of data (floating-point number or integer or text string or boolean), and that is what we call the variable's type.

Finally, the ''name'' of a variable is a unique text string that is used to identify the data container within the script. Like [[BSL:Functions|function]] names, variable names are case-sensitive (NOTE: all variables and functions are lower-case). Valid characters are: ''please fill me in''

An easy way to get the ''type'' and ''value'' of an existing BSL variable is to enter its ''name'' at the console in [[Developer Mode]]: you typically get console output like "bool: 1" or "int32: 42" or "float: 3.14" or "string: hello"

===Declaration and assignment===
If you want to use a new variable (data container), you must set it up (''declare'' it) first, with the '''var''' keyword. A declaration statement can look a bit like this:
var int my_superduper_integer;
var bool my_totally_awesome_boolean;
var string my_incredible_text_string;
var float my_cool_floating_point_number;
The first word is the keyword "var", next comes the type (keyword), then the name of the variable. The final ";" is required. The name can be any valid name (i.e., not a keyword and not containing invalid characters)

A declaration is usually seen at "global scope" (i.e., outside all functions). It is recommended to group declarations at the beginning of a BSL file (for readability), but it's not necessary. It is also not necessary (but strongly recommended) to declare a variable ''before'' the context where it is used for the first time.

On some occasions you may want to declare a ''local'' variable (i.e., to embed a declaration statement into a [[BSL:Functions|function]]). This feature will be detailed elsewhere.

'''Note''': BSL will not complain if you use a nonexistent variable for instance in a if condition. However this cause undefined behavior in your scripts (e.g. for instance I had a real case scenario where chr_wait_health did not work as expected) so make sure you always declare the variables that you are using in your scripts.

===Assignment===
You can assign a new value to an existing variable with the assignment operator "=". The name of the variable you want to modify is on the left-hand-side (LHS) of the "=", and on the right-hand-side (RHS) you can have any valid expression that evaluates/converts into the variable's type.

An assignment can be combined with a declaration (see above). That means the variable will have a definite value right after it is created. If you don't specify/define such a starting value, you should not, generally speaking, assume anything about the value.

However, apparently there ''are'' "default" values assigned to every variable even if it hasn't been defined yet. Those values are 0 (i.e., false) for bool, 0 for int and float, and "" (empty string) for string.

==Built-in variables==
All the built-in BSL variables are listed here, in alphabetical order.

;Color
:White: available on all versions
:Blue: command only exists in Mac Intel build
:Green: command only exists in Windows build
;Default value
:'''# !!!''': reset by engine at level load
:'''!?''': set by engine at game/level load, depends on [[persist.dat]]
;Works
:"OK": both platforms can use this command
:"OK-D": both platforms can use this command, but Windows Oni requires the Daodan DLL
:"OK-M": the command only works on Intel Macs
:"OK?": confirmation/refinement required
:"OK!": apparently works but makes the game crash/hang/etc. Use with caution if at all.
:"??": command may not work
:"NO": command is proven not to work

{|border=1 cellspacing=0 cellpadding=2
!Type!!Name!!Default value!!Comment!!Works
|-
|bool||[[ai2_barabbas_run]]||1
|"lets Barabbas run while carrying his gun"||OK
|-
|bool||[[ai2_blind]]||'''0 !!!'''
|"turns off the AI's visual sensing system"||OK
|-
|bool||[[ai2_boss_battle]]||'''0 !!!'''
|"enables AI boss-battle target selection" used in '''compound''': apparently makes Muro's friends focus on yours rather than on you. Only seems to have effect on ''Boss'' flagged characters at BINACJBOCharacter file. It seems that makes other characters try to ignore the ''Boss'' flagged character and make the ''Boss'' flagged character focus on the player rather the other characters.||OK
|-
|bool||[[ai2_chump_stop]]||'''0 !!!'''
|"stops the chump" disables the pathfinding behaviour of chump(s)||OK
|-
|bool||[[ai2_deaf]]||'''0 !!!'''
|"turns off the AI's sound sensing system"||OK
|-bgcolor="lime"
|int32||[[ai2_debug_localmove_lines]]||20
|"number of lines to cast to debug local-movement code"||OK
|-
|bool||[[ai2_debug_localmovement]]||0
|"debug local-movement code from player's position"||OK
|-
|bool||[[ai2_debug_localpathfinding]]||0
|"debug local-path code from player's position and facing"||OK
|-
|bool||[[ai2_debug_showsettingIDs]]||0
|"shows ID numbers for combat, melee and neutral settings"||??
|-
|bool||[[ai2_ignore_player]]||'''0 !!!'''
|"makes all AI ignore the player"||OK
|-
|bool||[[ai2_melee_weightcorrection]]||1
|"weights down non-attack techniques so they are never more than attacks"||??
|-
|bool||[[ai2_printspawn]]||0
|"prints information about each AI spawn"||OK
|-
|bool||[[ai2_showactivationpaths]]||0
|"turns on inactive ==> active pathfinding rendering"||OK
|-
|bool||[[ai2_showastar]]||0
|"shows grid squares that are evaluated by the A* pathfinding"||bgcolor=#ccccff|OK-M
|-
|bool||[[ai2_showcombatranges]]||0
|"shows circles that represent the combat ranges of each AI"||OK
|-
|bool||[[ai2_showconnections]]||0
|"turns on pathfinding connection rendering" (result of a call to [[ai2_findconnections]])||OK
|-
|bool||[[ai2_showdynamicgrids]]||0
|"turns on pathfinding dynamic grid display" (moving obstacles; needs '''ai2_showgrids''')||OK
|-
|bool||[[ai2_showfights]]||0
|"shows fights in progress"||OK?
|-
|bool||[[ai2_showfiringspreads]]||0
|"shows AI firing spread knowledge"||OK
|-
|bool||[[ai2_showgrids]]||0
|"turns on pathfinding grid rendering" (static grids; see [[OBD:AKVA|AKVA]])||OK
|-
|bool||[[ai2_showhealth]]||0
|"draws a health bar for every AI above their head"||OK
|-
|bool||[[ai2_showintersections]]||0
|"debug AI's melee intersections"||??
|-
|bool||[[ai2_showjoblocations]]||0
|"draws a green cross at each AI's job location"||OK?
|-
|bool||[[ai2_showlasers]]||0
|"turns on laser sights for AI2 characters"||??
|-
|bool||[[ai2_showlinetochar]]||0
|"draws a line from the player to every AI" (to be precise, it draws a line from the player to every spawned AI character, be it via [[ai2_spawn]] or via [[chr_create]])
<ul>
<li>green line: AI character is active and drawn</li>
<li>blue line: AI character is active, but not drawn</li>
<li>red line: AI character is inactive</li>
</ul>
Related BSL functions: [[chr_draw_all_characters]], [[chr_lock_active]], [[chr_unlock_active]] 
Related BSL variables: [[chr_all_active]]
||OK
|-
|bool||[[ai2_showlocalmelee]]||0
|"shows local-environment melee awareness"||OK?
|-
|bool||[[ai2_showlos]]||0
|"shows AI line-of-sight checking" (LOS of all aiming AI leaves a permanent trace)|| OK
|-
|bool||[[ai2_shownames]]||0
|"draws the name of every AI above their head"||OK
|-
|bool||[[ai2_showpathfindingerrors]]||0
|"enables visual display of pathfinding errors"||OK?
|-
|bool||[[ai2_showpaths]]||0
|"shows the path each AI is following"||OK
|-
|bool||[[ai2_showprediction]]||0
|"shows prediction info for AI2 characters" (player's "predicted" position is shown etc)||OK
|-
|bool||[[ai2_showprojectiles]]||0
|"shows AI projectile knowledge"||OK
|-
|bool||[[ai2_showsounds]]||0
|"shows AI sounds as they are generated"||OK
|-
|bool||[[ai2_showtargeting]]||0
|"shows targeting info for AI2 characters"||OK
|-
|bool||[[ai2_showvision]]||0
|"shows each AI's vision cones (central and peripheral)"||OK
|-
|int32||[[ai2_spacing_cookies]]||2
|"number of cookies per fight" the more cookies, the more attacks: 0 means nothing but maneuver||OK
|-
|bool||[[ai2_spacing_enable]]||1
|"master enable switch for spacing behavior"||OK?
|-
|bool||[[ai2_spacing_weights]]||1
|"enables position-sensitive weighting of spacing behaviors"||OK?
|-
|int32||[[ai2_stopignoring_count]]||6
|"set the number of events before the AI will stop ignoring"||??
|-
|int32||[[ai2_stopignoring_time]]||240
|"set the delay timer before the AI forgets about ignored events"||??
|-
|bool||[[am_hit_everything]]||0
|"makes the laser pointer hit all objects" (determines whether the gun's aiming laser stops at quads marked with non-object-collision)||bgcolor=#ccccff|OK-M
|-
|bool||[[am_invert]]||'''!?'''
|"inverts aiming" This is set from [[persist.dat]] at game load (in the absence of '''persist.dat''' the default is 0).
:The value 0 means normal aiming (mouse up to look up). The value 1 means inverted aiming (mouse down to look up).
|OK
|-
|bool||[[am_show_axes]]||0
|"shows world axes"
:This attaches a giant 3D axis to Konoko which claims to show the direction of positive x, y, and z in the world coordinate system, however it is '''wrong'''. Oni uses a Y-up coordinate system; do not let the 3D axis model showing Z-up mislead you.
|bgcolor=#ccccff|OK-M
|-
|bool||[[am_show_closest]]||0
|"dumps the closest GQ index to console" (continuously prints to console the nearest gunk quad's number followed by two other unhelpful pieces of info)||OK
|-
|bool||[[am_show_filenames]]||0
|"dumps the closest GQ index file/obj name to console" (displays lots of info on-screen, not in console, about quad you are aiming weapon at, but no file names)||bgcolor=#ccccff|OK-M
|-bgcolor=#ccccff
|bool||[[am_show_texturenames]]||0
|"Shows Texture name" (displays name of texture you are aiming weapon at, as well as coordinates of reticle)||OK
|-
|float||[[character_name_distance]]||150.
|"specifies the distance from the camera that character names no longer draw" (probably needs show_characters)||bgcolor=#ccccff|OK-M
|-
|bool||[[chr_active]]||1
|"enables character activity" (0 freezes animation etc)||OK
|-
|float||[[chr_aim_width]]||70.
|"number of degress of aiming width" width of the aiming arc, in degrees||OK
|-
|bool||[[chr_all_active]]||0
|"forces all characters to be active"||OK
|-
|float||[[chr_auto_aim_arc]]||90.
|"number of degress of auto aiming arc" width of the auto aiming arc, in degrees||OK
|-
|float||[[chr_auto_aim_dist]]||40.
|"distance for auto aiming" upper threshold, in world units||OK
|-
|bool||[[chr_big_head]]||'''0 !!!'''
|"draws everyone with a big head" (head size set by chr_big_head_amount)||OK
|-
|float||[[chr_big_head_amount]]||4.
|"Controls the size of the big head"||OK
|-
|float||[[chr_block_angle]]||20.
|"controls the angle at which the characters can block"||OK
|-
|int32||[[chr_buffer_size]]||8
|"0 = normal buffer, otherwise buffer duration"||??
|-
|bool||[[chr_collision_box]]||1
|"toggles character bounding box / bounding sphere collision"||??
|-
|float||[[chr_collision_grow]]||0.
|"sets character bounding box collision grow amount"||??
|-
|bool||[[chr_corpse_fade_offscreen]]||1
|"makes corpses fade when they are offscreen"||??
|-
|int32||[[chr_death_fade_frames]]||180
|"the number of game ticks until charaters fade over"||??
|-
|int32||[[chr_death_fade_start]]||7200
|"the number of game ticks until charaters begin to fade"||??
|-
|bool||[[chr_debug_aiming_screen]]||0
|"turns on aiming screen debugging" (dumps AS changes to console)||OK
|-
|bool||[[chr_debug_characters]]||0
|"enables debugging information for characters"||OK
|-
|bool||[[chr_debug_collision]]||0
|"turns on/off debugging of collision" (melee collision info written to console)||OK
|-
|bool||[[chr_debug_fall]]||0
|"controls debugging falling" (dumps events to console)||OK
|-
|bool||[[chr_debug_footsteps]]||0
|"footstep debugging mode" (dumps events to console)||OK
|-
|bool||[[chr_debug_footsteps_verbose]]||0
|"verbose footstep debugging mode" (dumps anim/type/frame to console)||OK
|-
|bool||[[chr_debug_handle]]||0
|"turns on debugging for the handle code" (dumps events to console)||OK
|-
|bool||[[chr_debug_impacts]]||0
|"prints debugging info about character melee impacts" (to console)||OK
|-
|bool||[[chr_debug_overlay]]||0
|"enables debugging information for overlays"||OK
|-
|bool||[[chr_debug_pathfinding]]||0
|"control pathfinding debugging"||OK
|-
|bool||[[chr_debug_sphere]]||0
|"enables sphere tree debugging for characters" (draws collision spheres for every character)||OK
|-
|int32||[[chr_debug_target]]||0
|"selects the character debugging target" (used by all debugging routines)||OK
|-
|bool||[[chr_debug_trigger_quad]]||0
|"controls trigger quad debugging" (draws characters as vertical lines)||OK
|-
|bool||[[chr_disable_melee]]||0
|"turns off all melee damage" (also disables knockdowns; does NOT disable throws)||OK
|-
|bool||[[chr_disable_visactive]]||0
|"disables visibility activation"||OK
|-
|bool||[[chr_draw_aiming_vector]]||0
|"enables drawing of the aiming vector"||OK
|-
|bool||[[chr_draw_all_characters]]||0
|"forces the drawing of all characters" (also keeps them active)||OK
|-
|bool||[[chr_draw_facing_vector]]||0
|"enables drawing of the facing vector"||OK
|-
|bool||[[chr_draw_weapon]]||1
|"controls drawing of weapons"||OK
|-
|bool||[[chr_enable_collision]]||1
|"enables character collision" (does NOT prevent throws if disabled)||OK
|-
|int32||[[chr_lod]]||-1
|"forces a given lod if it is between 0 and 4" (uses automatic LOD otherwise)||OK
|-
|bool||[[chr_mini_me]]||0
|"decreases the size of the main character" (Actually, this command allows the character to be made smaller or larger. The custom size is set by '''chr_mini_me_amount''' below.)||OK
|-
|float||[[chr_mini_me_amount]]||0.5
|"controls the size of the main character" (effective only if '''chr_mini_me''' is enabled) ''"1" represents "100% of normal size", so numbers between 0 and 1 scale the character down, and numbers above one scale the character up. If you supply "0", the character becomes invisible. If "-1", the character walks on the underside of the floor. With a very low number like -1000, the character will still walk below the floor but will be enormous (they will not be visible, however, as long as the camera remains above the floor); they will also lose collision with other characters, and sounds made by the character will not be heard.''||OK
|-
|bool||[[chr_pin_character]]||0
|"pins a character to the ground" (freezes the coordinates of ''all'' characters)||OK
|-
|bool||[[chr_print_sound]]||0
|"turns on printing of the sound effect"||??
|-
|bool||[[chr_show_bnv]]||0
|"shows the bnv of the main character" (pathfinding volume; see [[OBD:AKVA|AKVA]])||OK
|-
|bool||[[chr_show_lod]]||0
|"shows the current lod of the main character"||OK
|-
|int32||[[chr_show_movement]]||0
|"enables movement debugging information for characters" (dumps XZ velocity to console every # frames)||OK
|-bgcolor=#ccccff
|int32||[[chr_show_weaponid]]||0
|"Shows weapon ID"||OK
|-bgcolor=#ccccff
|bool||[[chr_showextent_globals]]||0
|"shows the global parts of an attack animation's extent"||OK
|-
|bool||[[chr_weapon_auto_aim]]||1
|"enables auto aiming" (melee auto aiming not affected)||OK
|-
|float||[[cinematic_xoffse]]t||20.
|"offset from the vertical edge of the screen for the cinematic insert"||??
|-
|float||[[cinematic_yoffset]]||65.
|"offset from the horizontal edge of the screen for the cinematic insert"||??
|-
|float||[[cm_canter_unarmed]]||8.
|"camera canter" (when not aiming; in degrees)||OK
|-
|float||[[cm_canter_weapon]]||7.
|"camera canter" (when aiming, in degrees)||OK
|-
|float||[[cm_distance]]||33.
|"camera distance" (to target, in world units)||OK
|-
|float||[[cm_height]]||15.
|"camera target" (target height to feet of target character, in world units)||OK
|-
|int32||[[cm_jello_amt]]||20
|"sets the transparency of walls" (for [[Jello-cam]] mode, in % )||OK
|-
|float||[[cm_jello_radius]]||12.
|radius of effect of [[Jello-cam]] mode||OK
|-
|float||[[cm_lookspring_percent]]||0.5
|"at what percent of lookspring fight mode turns off"||??
|-
|bool||[[cm_plane_test]]||1
|"jello camera plane test"||OK
|-
|bool||[[co_display]]||1
|"enables console display" (console output only)||OK
|-
|int32||[[co_fade_time]]||600
|"the fade time of the console"||OK
|-
|bool||[[co_message_display]]||1
|"enables text message display" (dmsg and prompts)||OK
|-
|int32||[[co_priority]]||0
|"changes the priority of messages to display on the console" not sure what messages have priority >0||OK
|-
|bool||[[debug_consoles]]||0
|"prints debugging information about console usage" (information about ''in-game'' consoles; prints to ''dev mode'' console ^^)||OK
|-bgcolor=#ccccff
|bool||[[debug_font_cache]]||0
|"displays font cache texture"||??
|-
|bool||[[debug_gun_behavior]]||0
|"enable AI gun behavior debugging" (dumps events to console)||OK
|-
|bool||[[debug_impacts]]||0
|"prints impacts as they occur" (to console; footsteps, melee, projectiles...)||OK
|-
|bool||[[debug_scripts]]||0
|"enable script debugging" (dumps events to console)||OK
|-
|bool||[[debug_triggers]]||0
|"enable trigger volume debugging" (dumps events to console)||OK
|-
|bool||[[debug_weapons]]||0
|"prints debugging info about weapon particle events"||OK
|-
|bool||[[door_drawframes]]||0
|"draws doorframes for all unplaced doors"||??
|-
|bool||[[door_ignore_locks]]||0
|"disables all door locks"||OK
|-
|bool||[[door_pop_lighting]]||0
|"uses bad door lighting"||??
|-
|bool||[[door_show_activation]]||0
|"draws a circle where door activates"||??
|-
|bool||[[door_show_debug]]||0
|"shows debug geometry" (dumps events to console)||OK
|-
|bool||[[draw_every_frame]]||0
|"forces drawing of every frame" (every '''draw_every_frame_multiple'''th frame; takes precedence over '''fast_mode''')||OK
|-
|int32||[[draw_every_frame_multiple]]||1
||"draw every frame multiple" set drawing frequency if '''draw_every_frame''' is ON||OK
|-
|bool||[[env_collision]]||1
|"enables environment collision"||??
|-
|bool||[[env_drawallgqs]]||0
|"draw all the GQs"||??
|-
|bool||[[env_drawfrustum]]||0
|"draw the frustum around the environment camera"||??
|-
|bool||[[env_drawvisonly]]||0
|"draw only the GQs used for visibility"||??
|-
|int32||[[env_highlight_gq]]||-1
|"highlights a particular gq" (-1 means none)||OK
|-
|int32||[[env_ray_number]]||20
|"sets the number of rays to cast" (per frame). Bigger values than 20 may be ineffective (cause the console message "allocated too many akira rays")||OK
|-
|bool||[[env_show_ghostgqs]]||0
|"when true show ghost GQs" (PC&Mac: Works only for self-made GQs via onisplit v0.9.93.0 -create:level in '''-debug''' out/*.xml; )||OK
|-
|bool||[[env_show_leafnodes]]||0
|"enables display of environment octtree leaf nodes"||??
|-
|bool||[[env_show_octnode_gqs]]||0
|"when true the environment only renders triangles in the octnode that contains the manual camera"||??
|-
|bool||[[env_show_octtree]]||0
|"enables display of environment octtree traversal"||??
|-
|bool||[[env_show_quad_count]]||0
|"shows the count of visable environment quads"||??
|-
|bool||[[env_show_rays]]||0
|"draw the rays"||??
|-
|bool||[[env_show_stairflagged]]||0
|"show specially flagged noncollision quads" (not sure what this was supposed to do, but the dev keys for "Character collision" (Ctrl-Shift-T) and "Invisible quads" (Ctrl-Shift-I) will show stair collision ramps)||??
|-
|bool||[[fast_lookup]]||1
|"enables fast lookup"||??
|-
|bool||[[fast_mode]]||0
|"makes the game run fast" (only if '''draw_every_frame''' is disabled)||OK
|-
|float||[[flag_name_distance]]||150.0
|"specifies the distance from the camera that flag names no longer draw" (probably needs show_flags)||??
|-
|int32||[[flag_new_id]]||'''!?'''
|"specifies the id for a new flag" (equal to the last flag added at level load)||??
|-
|bool||[[footstep_flash]]||0
|"footstep flash mode"||OK
|-
|float||[[fx_laser_width]]||0.2
|width of lasers (weapons and triggers)||OK
|-
|bool||[[gl_disable_depth_reads]]||0
|"disable_depth_reads"||??
|-bgcolor=#ccccff
|bool||[[gl_disable_dxt1]]||0
|"lets you disable use of DXT1"||??
|-bgcolor=#ccccff
|bool||[[gl_disable_packed_pixels]]||0
|"lets you disable packed-pixels support"||??
|-
|float||[[gl_fog_blue]]||'''0.25 !!!'''
|"fog blue" (amount: 0 to 1)||OK
|-
|float||[[gl_fog_end]]||'''1. !!!'''
|"fog end" in frustum space||OK
|-
|float||[[gl_fog_green]]||'''0.25 !!!'''
|"fog green" (amount: 0 to 1)||OK
|-
|float||[[gl_fog_red]]||'''0.25 !!!'''
|"fog red" (amount: 0 to 1)||OK
|-
|float||[[gl_fog_start]]||'''0.975 !!!'''
|"fog start" in frustum space||OK
|-bgcolor=#ccccff
|int32||[[gl_mipmap_offset]]||0
|"lets you disable miplevels (-ve = disable big, +ve = disable small)"||??
|-
|float||[[gs_input_accel]]||5.0
|"use this to control the input sensitivity" (affects the camera movement keys for the free-roaming camera in [[Dev Mode]])||OK
|-
|int32||[[gs_screen_shot_reduce]]||0
|"2^n amount of reduction"||OK
|-
|bool||[[gs_show_characters]]||1
|"turns on the drawing of characters"||OK
|-
|bool||[[gs_show_corpses]]||1
|"show corpses"||OK
|-
|bool||[[gs_show_environment]]||1
|"turns on doing the environment"||OK
|-
|bool||[[gs_show_object_count]]||0
|"shows the count of objects"||??
|-
|bool||[[gs_show_objects]]||1
|"turns on the drawing of objects"||OK
|-
|bool||[[gs_show_particles]]||1
|"turns on the drawing of particles"||OK
|-
|bool||[[gs_show_physics_count]]||0
|"shows the count of physics"||??
|-
|bool||[[gs_show_scripting_count]]||0
|"shows the count of active scripting contexts"||??
|-
|bool||[[gs_show_shadows]]||1
|"enables character shadows"||OK
|-
|bool||[[gs_show_sky]]||1
|"turns on the sky"||??
|-
|bool||[[gs_show_ui]]||1
|"turns on the ui" (aka HUD)||OK
|-
|bool||[[gs_sleep]]||0
|"turns on a call to sleep to make debugging easier"||??
|-
|bool||[[gs_stable_ear]]||1
|"makes the ear stable"||??
|-
|bool||[[invincible]]||'''0 !!!'''
|"makes player invincible"||OK
|-
|bool||[[laser_alpha]]||0
|WTF? lasers are always transparent||??
|-bgcolor="lime"
|bool||[[li_center_cursor]]||1
|"should we center the cursor"||OK
|-
|bool||[[m3_buffer_clear]]||1
|"toggles buffer clear"||OK
|-
|int32||[[m3_clear_color]]||0
|"color to clear the back buffer to" (color behind skybox) (actually a 32-bit RGB integer; can calculate it with [http://www.shodor.org/stella2java/rgbint.html this site])||OK
|-
|bool||[[m3_double_buffer]]||1
|"toggles double buffer mode" (may interrupt rendering if disabled! use with caution)||OK!
|-
|bool||[[m3_fill_solid]]||1
|"toggles wireframe/solid"||OK
|-
|bool||[[m3_shade_vertex]]||1
|"vertex shader on/off"||OK
|-
|bool||[[m3_texture]]||1
|0 >> crash ^^||OK!
|-
|bool||[[m3_zcompareon]]||1
|"true if zcompare is on"||OK
|-
|bool||[[marketing_line_off]]||'''0 !!!'''
|"turns the laser line off"||OK
|-bgcolor=#ccccff
|float||[[mouse_acceleration]]||0.75
|"sets the mouse acceleration value"||OK
|-
|bool||[[ob_show_debug]]||0
|"enable physics debugging visuals" (shows spheres for doors etc)||OK
|-
|bool||[[omnipotent]]||'''0 !!!'''
|"makes player omnipotent"||OK
|-
|int32||[[p3_debug_collision]]||256
|"enables collision debugging display" (actually a boolean; only the low bit counts)||OK
|-
|bool||[[p3_everything_breakable]]||0
|"makes every quad breakable"||OK
|-
|bool||[[p3_furniture_breakable]]||0
|"makes all furniture breakable"||OK
|-
|bool||[[p3_glass_breakable]]||1
|"enables breakable glass"||OK
|-
|bool||[[p3_show_env_collision]]||0
|"draws particle / environment collisions"||OK
|-
|float||[[patrolpath_name_distance]]||150.0
|"specifies the distance from the camera that patrol point names no longer draw" (probably needs show_patrolpaths)||bgcolor=#ccccff|OK-M
|-
|bool||[[ph_active]]||1
|"enable physics"||OK
|-
|bool||[[ph_debug_keyforces]]||0
|"toggle keyboard applied forces"||??
|-
|bool||[[ph_show_collisions]]||0
|"toggle display of colliding quads" (also see show_chr_env_collision)||OK
|-
|float||[[recoil_base]]||0.0
|"base" (for current ONWC; needs recoil_edit)||OK
|-
|bool||[[recoil_edit]]||0
|"enables editable recoil" ||OK
|-
|float||[[recoil_factor]]||0.0
|"factor" (for current ONWC; needs recoil_edit)||OK
|-
|float||[[recoil_max]]||0.0
|"factor" (for current ONWC; needs recoil_edit)||OK
|-
|float||[[recoil_return_speed]]||0.0
|"factor" (for current ONWC; needs recoil_edit)||OK
|-
|int32||[[save_point]]||'''!?'''
|which save point we are on||OK
|-
|int32||[[saved_film_character_offset]]||1
|"dumps the filmed animation data of the player to file"||OK?
|-
|bool||[[saved_film_loop]]||0
|enables looping when '''play_record'''ing||OK
|-
|string||[[sc_bind_f2]]||""
|name of animation bound to '''cutscene1'''||OK
|-
|string||[[sc_bind_f3]]||""
|name of animation bound to '''cutscene2'''||OK
|-
|bool||[[show_characters]]||0
|"enables the display of character starting positions" (see BINA/OBJC/CHAR)||bgcolor=#ccccff|OK-M
|-
|bool||[[show_chr_env_collision]]||0
|"draws character / environment collisions" (shows all quads that character touches, unlike ph_show_collisions which only shows quad you are standing on)||OK
|-
|bool||[[show_flags]]||0
|"enables the display of flags" (see BINA/OBJC/FLAG)||bgcolor=#ccccff|OK-M
|-
|bool||[[show_laser_env_collision]]||0
|"draws laser / environment collisions" (works with any loaded gun)||OK
|-
|bool||[[show_patrolpaths]]||0
|"enables the display of AI patrol path objects" (see BINA/OBJC/PATR)||bgcolor=#ccccff|OK-M
|-
|bool||[[show_performance]]||0
|"enables performance display" (shows FPS counter)||OK
|-
|bool||[[show_performance_gsd]]||0
|??||??
|-
|bool||[[show_performance_gsu]]||0
|??||??
|-
|bool||[[show_sound_all]]||0
|"sound rings will always be drawn, not just when a sound is selected" (environment sounds, see BINA/OBJC/SNDG)||bgcolor=#ccccff|OK-M
|-
|bool||[[show_sound_rectangles]]||0
|"sound rectangles will always be drawn, not just when a sound Rectangle is selected" (environment sounds, see BINA/OBJC/SNDG)||bgcolor=#ccccff|OK-M
|-
|bool||[[show_sound_spheres]]||0
|"sound spheres will always be drawn, not just when a sound sphere is selected" (environment sounds, see BINA/OBJC/SNDG)||bgcolor=#ccccff|OK-M
|-
|bool||[[show_triggers]]||1
|"enables the display of triggers" (see BINA/OBJC/TRIG)||OK
|-
|bool||[[show_triggervolumes]]||0
|"Display trigger volumes"||OK-D
|-
|bool||[[show_turrets]]||1
|"enables the display of turrets" (see BINA/OBJC/TURR)||OK
|-
|bool||[[single_step]]||0
|"puts the game in single step mode" (see [[Developer_Mode#Features]] for single-step control)||OK!
|-
|float||[[sky_height]]||'''0. !!!'''
|Y offset of skybox?||??
|-
|bool||[[sky_show_clouds]]||1
|"toggles display of the clouds"||??
|-
|bool||[[sky_show_planet]]||1
|"toggles display of the planet (sun/moon)" (sun present only in levels 2 and 3)||OK
|-
|bool||[[sky_show_sky]]||1
|"toggles display of the sky" (master switch)||OK
|-
|bool||[[sky_show_skybox]]||1
|"toggles display of the skybox"||OK
|-
|bool||[[sky_show_stars]]||1
|"toggles display of the stars" (no stars in any level)||??
|-
|bool||[[sound_show_debug]]||0
|"displays sound debugging info" (shows a HUD with info on currently playing sounds; on Macs, sound spheres are also displayed)||OK
|-bgcolor=#ccccff
|bool||[[sound_show_occlusions]]||0
|"enables debugging display of sound occlusions" (shows lines from sound sources to listeners)||OK
|-
|bool||[[spatial_footsteps]]||1
|"spatial footsteps"||??
|-
|bool||[[sync_debug]]||0
|"enables sync debugging"||??
|-
|float||[[target_max_distance]]||75000.
|"Sets the distance at which the radar will start to change from its minimum"||OK
|-
|bool||[[turret_show_debug]]||0
|"enables the display of turret debug lines"||bgcolor=#ccccff|OK-M
|-
|bool||[[ui_suppress_prompt]]||'''0 !!!'''
|"suppresses UI prompting about new objectives or moves" (and saved games and training tips and such)||OK
|-
|bool||[[unstoppable]]||'''0 !!!'''
|makes player unstoppable||OK
|-
|bool||[[wait_for_key]]||0
|"makes the game wait for a key before level load"||OK
|-
|bool||[[wp_disable_fade]]||0
|"disables weapon fading"||OK
|-
|int32||[[wp_fadetime]]||360
|"sets free time for powerups"||OK-D
|-
|bool||[[wp_force_half_scale]]||0
|crosshairs scale with distance, pow_adjustment redundant||OK
|-
|bool||[[wp_force_no_scale]]||0
|crosshairs don't scale with distance, pow_adjustment ineffective||OK
|-
|bool||[[wp_force_scale]]||0
|crosshairs scale with distance, pow_adjustment ineffective||OK
|-
|int32||[[wp_hypostrength]]||25
|"sets strength of hypo spray" apparently in % of full health, seems hard-coded||??
|-
|bool||[[wp_kickable]]||0
|"lets the player kick weapons" (actually lets everyone ''but'' the player collide with guns)||OK
|-
|float||[[wp_pow_adjustment]]||0.3
|scales crosshair separately (or not, depending on "force" flags)||OK
|-
|float||[[wp_scale_adjustment]]||1.
|adjusts scales||OK
|}

[[Category:BSL docs]]
[[Category:Scripting tasks]]

BSL:Functions

2020-06-28T04:17:06Z

Samer:

{{TOCfloat}}
==Signature==
===Arguments===
Put usage of brackets and commas here. Also tell about the weak syntax (with space as a separator).
===Return value===
When used alone forces the exit from a function. When used with a variable it forces the exit from a function and returns that variable.

Example (1)

<pre>
func void spawnUs () {
ai2_spawn(Muro);
sleep(200);
return;
ai2_spawn(Barabas);
}
</pre>

In this example the code <tt>ai2_spawn(Barabas);</tt> is never executed.

Example (2)

<pre>
var int current_char_id=0;

func int spawnCharacter (string char_name) {
ai2_spawn(char_name);
current_char_id=current_char_id+1;
return current_char;
dmsg("Hello.");
}
</pre>

In this example the current_char is returned from the function (notice the int declaration at the begin of function, which declares the type to return). <tt>dmsg("Hello.");</tt> is never executed.

==Declaration==
Put usage of <tt>func</tt> here.
: [...]
* Tips:
** If you call a second function from inside another function, the second function will be executed til its end and then the rest of the first function gets executed.
** You can call a function recursively, but only up to about four times, then the script execution stucks for some reason (maybe intentional to prevent endless loops?).
** BSL doesn't allow function name overriding even if the parameters are different (in java you can for example).
** Seems there is a limit of 8 parameters for each function.
{{clearall}}
==Multithreading==
Put usage of <tt>fork</tt> here.
: [...]
* Tips:
** Use "fork" in conjunction with "sleep" to ensure that there is always only one running copy of the function. (Themselves looping functions without sleep can crash the game.)
** And remember to design the code so it cannot create two copies of the function running in parallel. When that happens, the desired loop effect is usually broken and "echos" start to apprear.
==chr_index==
<tt>chr_index</tt> is a variable required by some functions like <tt>chr_focus</tt>. This variable hold a ID for a character and each character have a <tt>chr_index</tt> associated.

Normally the chr_index is associated by the order of the spawn of the characters. The characters can be spawned either by scripting or by the engine itself (if it doesn't have <tt>NotInitiallyPresent</tt> flag at <tt>BINACJBOCharacter</tt> file).

For example:
<pre>
ai2_spawn Muro
ai2_spawn Mukade
ai2_spawn Bomber
</pre>

With the follow code Muro will receive the index 1, Mukade index 2 and Bomber index 3. Konoko always have a <tt>chr_index</tt> of 0, because it's always the first character to be spawned.

This ok, but there's an exception. Once a character is deleted, either by be killed (and the engine delete it automatically) or by calling <tt>chr_delete</tt> directly the following characters to be spawned will fill the holes left by the deleted.

For example:
<pre>
ai2_spawn Muro
ai2_spawn Mukade
chr_delete Mukade
ai2_spawn Bomber
</pre>

In this example Mukade have the index 2, but once it's deleted (in this case directly by <tt>chr_delete</tt> function) there will be hole where his id were. When Bomber is spawned, it isn't associated the index 3, but it will be associated the index 2, to fill the hole left behind.

Seems the <tt>chr_index</tt> variables make part of an array in memory, once some variable in the array is cleared, in the next opportunity it is filled up again.

If you want to reset <tt>chr_index</tt> you may want to use <tt>ai2_reset</tt>, which resets all characters to level initial state (take a look at <tt>ai2_reset</tt> implications before using it [http://wiki.oni2.net/BSL:Functions#ai2 here]).

==Native functions==
Line structure: script command [parameter] - description - example

Parameter:
*parameter
:you have to use this parameter
*[parameter]
:IMO, this parameter is an option. You can use it or not.
*(null)
:type only the script command, nothing else
*no parameter given
:type the script command and add "= 0" or "= 1" (sometimes you can add higher numbers, e.g. cm_distance = 200)

*Commands in this color are Windows-only
*Commands in this color are Mac-only

===ai2===
'''Commands which can have an effect on all AIs (see below to use these same commands on one AI):'''

*ai2_allpassive passive:int {0 | 1} - stops all AIs from thinking for themselves - ai2_allpassive 1
*ai2_spawnall (null) - spawns all AI, even those not initially present - ai2_spawnall
*ai2_takecontrol on_off:int {0 | 1} - makes the AI movement system take control of the player - ai2_takecontrol 1
*ai2_kill [int] - kills all AIs, just use a number as parameter instead of a string

'''Commands which have an effect on one AI:'''
*ai2_active [ai_name:string | script_id:int] - forces an AI into active mode
*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
*ai2_barabbas_retrievegun [ai_name:string | script_id:int] - makes barabbas retrieve his gun if it is lost - ai2_barabbas_retrievegun barabus
*ai2_chump (null) - creates a chump
*ai2_comehere [ai_name:string | script_id:int] - tells an AI to come to the player
*ai2_debug_makesound [sound_type:string | ] [volume:float | ] - causes the player to make a sound (alerts nearby AIs)
*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''
*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''
*ai2_findconnections [distance:int | ] - finds all BNV connections from the player's location
*ai2_followme [ai_name:string | script_id:int] - tells an AI to follow the player - ai2_followme s2_t05
*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
*ai2_idle [ai_name:string | script_id:int] - tells an AI to become idle - ai2_idle A1_intro01
*ai2_inactive [ai_name:string | script_id:int] - forces an AI into inactive mode
*ai2_kill [param1:string] [param2:string] - kills one or more AIs - ai2_kill ScanKerr01 // ai2_kill
*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''
*ai2_lookatme [ai_name:string | script_id:int] - tells an AI to look at the player - ai2_lookatme s2_t05
*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
*ai2_makeblind [ai_name:string | script_id:int] on_off:int{0 | 1} - makes a single AI blind - ai2_makeblind ShinShin 1
*ai2_makedeaf [ai_name:string | script_id:int] on_off:int{0 | 1} - makes a single AI deaf - ai2_makedeaf ShinShin 1
*ai2_makeignoreplayer [ai_name:string | script_id:int] on_off:int{0 | 1} - makes a single AI ignore the player - ai2_makeignoreplayer ParkStriker 1
*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'' 
''ai2_movetoflag will only work if there is a path to that flag''
*ai2_neutralbehavior [ai_name:string | script_id:int] behavior:string - sets up an AI's neutral-interaction - ai2_neutralbehavior neutral_3 none
*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
*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''
*ai2_pathdebugsquare x:int y:int - selects a path square in the player's BNV for debugging
*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
*ai2_report [ai_name:string | script_id:int | ] - tells an AI to report in
*ai2_report_verbose [ai_name:string | script_id:int | ] - tells an AI to report in verbosely
*ai2_reset [reset_player:int] - resets AI as if start of level - ai2_reset
''resets consoles and clears characters as if you started the level again''
*ai2_set_handlesilenterror handle_silent:bool [subsystem:string | ] - sets whether handled errors are silent
*ai2_set_logerror error_level:string [subsystem:string | ] - sets the level of errors to log to file
*ai2_set_reporterror error_level:string [subsystem:string | ] - sets the level of errors to report at console
*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)
*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''
*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''
*ai2_showmem - shows AI memory usage
*ai2_skill_bestangle best_angle:float - sets an AI's best aiming angle in degrees
*ai2_skill_decay decay_amount:float - sets an AI's grouping decay
*ai2_skill_delaymax maxdelay:int - sets an AI's max delay between shots, in frames
*ai2_skill_delaymin mindelay:int - sets an AI's min delay between shots, in frames
*ai2_skill_error error_amount:float - sets an AI's grouping error (demonstration [https://youtu.be/cxTz30YOPhc HERE])
*ai2_skill_inaccuracy inaccuracy:float - sets an AI's shooting inaccuracy multiplier
*ai2_skill_recoil recoil_compensation:float - sets an AI's recoil compensation amount (0-1)
*ai2_skill_revert - reverts the shooting skill being edited to the saved copy
*ai2_skill_save - saves the shooting skill being edited out as a text file
*ai2_skill_select char_class:string weapon_name:string - selects a shooting skill to edit
*ai2_skill_show - shows the currently selected shooting skill
*ai2_spawn ai_name:string [force_spawn:string{"force"}] - creates and starts an AI from a character object - ai2_spawn ambush_striker_2
*ai2_tripalarm - alarm_id:int [ai_name:string | script_id:int] - trips an alarm - ai2_tripalarm 2 0

===chr===
'''Commands which have an effect on all characters:'''

*chr_kill_all_ai (null) - kills all the AI (not working?)

'''Commands which have an effect on one character:'''

*chr_animate [ai_name:string | script_id:int] anim_name:string [num_frames:int] [interp_frames:int] - plays an animation on a character - chr_animate 0 KONOKOcycle_ride 500
*chr_animate_block [ai_name:string | script_id:int] anim_name:string [num_frames:int] [interp_frames:int] - plays an animation on a character and blocks until done - chr_animate_block 0 KONOKOlev11_cnsl_idle 300
*chr_boss_shield [ai_name:string | script_id:int] - turns on the boss shield for a character - chr_boss_shield OutroNinja
*chr_changeteam [ai_name:string | script_id:int] team_name:string - changes a character's team - chr_changeteam guard1 Syndicate
''team name strings: Konoko, TCTF, Syndicate, Neutral, SecurityGuard, RogueKonoko, Switzerland, SyndicateAccessory''
*chr_create script_id:int [start_create:string {"start"} | ] - creates a character from an ID of the AISA file - chr_create 1050 start
*chr_death_lock [ai_name:string | script_id:int] [on_off:int{0 | 1}] - this character will not die too much - chr_death_lock dum_hit_flash 1
*chr_delete [ai_name:string | script_id:int] - deletes a character - chr_delete liliput_striker_1
*chr_disarm chr_index:int - disarms a character or everyone
*chr_display_combat_stats chr_index:int - displays the characters combat stats
*chr_dontaim [ai_name:string | script_id:int] on_off:int{0 | 1} - disables the weapon variant for a character
*chr_draw_dot - draws a dot at a specified location
*chr_envanim [ai_name:string | script_id:int] anim:string [norotation:string{"norotation"} | ] - plays an environment animation on a character - chr_envanim 111 OutroNinjaBox01 norotation
*chr_envanim_block [ai_name:string | script_id:int] anim:string [norotation:string{"norotation"}] - plays an environment animation on a character and blocks - chr_envanim_block 110 OutroNinjaBox01 norotation
*chr_envanim_stop [ai_name:string | script_id:int] - stops any environment animation on a character - chr_envanim_stop IntroNinja
*chr_facetoflag [ai_name:string | script_id:int] flag_id:int - snaps a character's facing to a flag's facing - chr_facetoflag IntroNinja 600
*chr_focus chr_index:int - Selects what character to control - chr_focus 1
*chr_forceholster [ai_name:string | script_id:int] holster:int{0 | 1} [force_draw:int{0 | 1}] - forces a character to holster their weapon - chr_forceholster IntroStriker02 1
*chr_freeze [ai_name:string | script_id:int] passive:int{0 | 1} - stops an AI from thinking for itself -chr_freeze A1_intro01 1
''[ai_name:string | script_id:int] = 0 don't work''
*chr_full_health [ai_name:string | script_id:int] - sets a characters health to full by script id - chr_full_health 0
*chr_givepowerup [ai_name:string | script_id:int] powerup:string [amount:int] - gives a character a powerup -chr_givepowerup 0 ammo 1
''powerup strings: ammo, cell, hypo, shield (in percent), invis (invisibility in frames, -1 = forever), lsi (amount is ignored)''
*chr_giveweapon [ai_name:string | script_id:int] weapon_name:string - gives a character a new weapon - chr_giveweapon 0 w1_tap
''weapon strings: w1_tap, w2_sap, w3_phr, w4_psm, w5_sbg, w6_vdg, w7_scc, w8_mbo, w9_scr, w10_sni, w11_ba1, w12_ba2''
*chr_has_empty_weapon [ai_name:string | script_id:int] - returns if this character is holding a weapon that is empty - chr_has_empty_weapon(char_0)
''This function only returns if the player is out of ammo for the weapon and the weapon is also empty.''
*chr_has_lsi [ai_name:string | script_id:int] - records that the character has the lsi - chr_has_lsi(0)
*chr_health chr_index:int [hit_points:int] - sets character's health - chr_health 0 300
*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
*chr_inv_reset [ai_name:string | script_id:int] - clears a characters inventory - chr_inv_reset ambush_tanker_1a
*chr_invincible [ai_name:string | script_id:int] [on_off:int{0 | 1}] - makes a character invincible - chr_invincible char_0 1
*chr_is_player [ai_name:string | script_id:int] - returns if this character is the player - chr_is_player(character)
*chr_location chr_index:int [loc_x:float loc_y:float loc_z:float] - Sets the location of any character -chr_location 0 100 100 100
''The first parameter is [ai_name:string | chr_index:int] on Macs, that is, you can supply the name of the AI or its index number.''
*chr_location_settocamera chr_index:int - Sets the location of any character to the camera location -chr_location_settocamera 1
*chr_lock_active [ai_name:string | script_id:int] - locks the character active - chr_lock_active IntroMuro
*chr_main_class [class_name:string | class_index:int] - sets the main characters class - chr_main_class striker_easy_1
''If you provide an index > than the available number of characters (nc), the engine will automatically subtract the number of characters how many times as needed to find a proper character index. For instance if you have nc = 85 and you input chr_main_class(180), the engine will change your class to the index 10 (180-85-85)''

''The practical effect seems to be different than chr_set_class (besides the parameters). For example with chr_main_class(ninja_hard_1) your ninja will be right handed while with chr_set_class(0,ninja_hard_1) your ninja will be left handed. Other difference is that chr_main_class seem to disable the daodan effect when using chr_super in the character itself.''
*chr_neutral [ai_name:string | script_id:int] passive:int{0 | 1} - stops an AI from thinking for itself - chr_neutral ParkStriker 1
*chr_nocollision [ai_name:string | script_id:int] on_off:int{0 | 1} - disables collision for a character - chr_nocollision 0 1
*chr_pain [ai_name:string | script_id:int] pain_type:string - forces a character to play a pain sound ''pain type strings: light, medium, heavy, death''
*chr_peace [ai_name:string | script_id:int] - turns off fight mode - chr_peace 0
''Normally used in cutscenes so the player leaves the fighting pose.''
*chr_playback [ai_name:string | script_id:int] film_name:string [mode:string{"fromhere" | "interp"}] [num_frames:int] - plays back a film
*chr_playback_block [ai_name:string | script_id:int] film_name:string [mode:string{"fromhere" | "interp"}] [num_frames:int] - plays back a film and blocks until complete
*chr_playback_debug film_name:string - dumps stats for a playback film
*chr_poison [ai_name:string | script_id:int] damage:int interval:int [initial_interval:int] - slowly poisons a character - chr_poison (konoko, 10, 60, 90);
''This is intended to be called in a continuous stream for a character standing in a trigger volume which represents an area that does ambient damage, such as a fire. No damage is done for the first "initial_interval" frames that the function is called, or, when "initial_interval" is not supplied, for the first "interval" frames; and then additional damage is only done once every "interval" frames as the function continues to be called every frame by the TV. Thus, calling this function a single time directly from a script will have zero effect.''
*chr_set_class chr_index:int [class_name:string | class_index:int] - sets the character class of a specific character, class must exist otherwise the game crashes - chr_set_class 0 striker_easy_1
*chr_set_health [ai_name:string | script_id:int] hit_points:int - sets a characters health by script id - chr_set_health dum_hit_flash 50
*chr_shadow [ai_name:string | script_id:int] [on_off:int{0 | 1}] - turns of the shadow for this character - chr_shadow ZomShin 1
*chr_showextent [anim_name:string] - shows the attack extent of an animation - chr_showextent KONOKOjump_bk_kick
''chr_showextent_globals must be on for this to work.''
*chr_showextent_globals - shows the global parts of an attack animation's extent - chr_showextent 1
*chr_super [ai_name:string | script_id:int] super_amount:float - set's a character's super value (the command isn't restricted to enable or disable the daodan particles, a value > 1 will make the daodan particles glow more), this command does not seem to affect the damage dealt in any way (differently from normal hypo over health) - chr_super 0 1
*chr_talk [ai_name:string | script_id:int] sound_name:string pre_pause:int post_pause:int [priority:string | ] - causes a character to play a line of dialogue - chr_talk victim_mansci_1 c02_62_11sci 0 0
*chr_teleport [ai_name:string | script_id:int] flag_id:int - teleports a character to a flag - chr_teleport 0 105
*chr_ultra_mode [ai_name:string | script_id:int] [on_off:int{0 | 1}] - enables ultra mode for a character
*chr_unkillable [ai_name:string | script_id:int] [on_off:int{0 | 1}] - makes a character unkillable - chr_unkillable A1_intro01 1
*chr_unlock_active [ai_name:string | script_id:int] - unlocks the character active
*chr_unstoppable [ai_name:string | script_id:int] [on_off:int{0 | 1}] - makes a character unstoppable - chr_unstoppable IntroMuro 1
*chr_vocalize [ai_name:string | script_id:int] type:string - makes a character utter a vocalization (vocalize type strings: taunt, alert, startle, checkbody, pursue, cower, superpunch, superkick, super3, super4). Character must be present in AISA file in order to work. Otherwise it will vocalize only the player.
*chr_wait_animation [ai_name:string | script_id:int] [anim_name:string] - waits for a character to play a specific animation - chr_wait_animation 0 KONSPRrun_lt KONSPRrun_rt
*chr_wait_animstate [ai_name:string | script_id:int] [anim_name:string] - waits for a character to reach a specific animation state - chr_wait_animstate 0 run_slide
*chr_wait_animtype [ai_name:string | script_id:int] [anim_name:string] - waits for a character to play a specific animation type - chr_wait_animtype 0 jump
*chr_wait_health [ai_name:string | script_id:int] health_amount:int32 - waits until a character's health falls below a value - chr_wait_health Muro 200
*chr_weapon chr_index:int [weapon_name:string | weapon_num:int] - sets the weapon for a give character
*chr_weapon_immune [ai_name:string | script_id:int] - makes a character weapon immune - chr_weapon_immune(vat_bot_1); // chr_weapon_immune 0
*chr_who - lists all the players
*where [ai_name:string | script_id:int | ] - prints location of a character
*who - prints AIs that are nearby

===cinematic===
[[Image:Cinematic_flags.jpg|thumb|right|This picture shows the layout of the "flags" used by cinematic_start/stop's start:int and end parameters.]]
*cinematic_start bitmap_name:string draw_width:int draw_height:int start:int end:int velocity:float mirror:bool - start the display of a cinematic insert - cinematic_start (MUROtalking, 180, 180, 15, 1, 15, false)
*cinematic_stop bitmap_name:string end:int velocity:float - stop the display of a cinematic insert - cinematic_stop (KONtalkangryfront, 16, 20)
''see picture on right for locations that insert can be placed; if you give a flag value of 0, the picture is displayed in the top-left corner of the screen'' 
''the yellow area's flags are off-screen; these are used for the start position of the fly-in so the picture slides on-screen instead of popping up on-screen''

===camera===
*cm_anim cam_spec:string{"move" | "look" | "both"} anim_name:string - initiates a camera animation - cm_anim both OutroCam03
*cm_anim_block cam_spec:string{"move" | "look" | "both"} anim_name:string - initiates a camera animation - cm_anim_block both OutroCam04
*cm_barabus [ai_name:string | script_id:int] away:float up:float time:int - special camera for barabus
*cm_detach (null) - detaches the camera - cm_detach
*cm_interpolate cam_name:string num_frames:int - initiates a camera interpolation - cm_interpolate GrifCam01 180
*cm_interpolate_block anim_name:string num_frames:int - initiates a camera interpolation - cm_interpolate_block OutroCam05 180
*cm_jello mode:int {0 | 1} - toggles camera Jello(tm) mode - cm_jello 1
''if cm_jello 0, the walls aren't transparent any longer''
*cm_orbit speed:float [stopangle:float] - puts the camera in orbit mode - cm_orbit .1
*cm_orbit_block speed:float [stopangle:float] - puts the camera in orbit mode - cm_orbit_block 2 180
*cm_reset [maxspeed:float] [maxFocalAccel:float] - resets the camera - cm_reset
*cm_wait (null) - makes the camera wait until it is no longer busy - cm_wait

===developer console===
*co_show_all - shows all registered variables and commands - co_show_all
*console_print - dumps all arguments
*co_toggle_text - cycles console text color
*dump_docs - shows all registered variables and commands
*text_console name:string - turns on the text console display

===console===
*console_activate console_id:int - activates a console - console_activate 14
*console_deactivate console_id:int - deactivates a console - console_deactivate 5
*console_reset console_id:int - resets a console to initial state - console_reset 7 text_console name:string - Turns on the text console display - text_console level_6d

===corpse===
*corpse_reset (null) - resets corpses to their initial state - corpse_reset
*make_corpse corpse_name:string - makes a corpse
*trigvolume_corpse trig_id:int - kills all the corpses inside a trigger volume - trigvolume_corpse 32

===cutscene===
*begin_cutscene flag:string{"weapon" | "jello" | "ai" | "invis" | "nosync" | "keepparticles" | "animation" | "nojump"} - begins a cutscene - begin_cutscene
''begin_cutscene weapon - player does not holster his weapon when cutscene starts'' 
''what about ai, animation, invis, jello, keepparticles, nojump, nosync? Oni's scripts only call begin_cutscene with jello, weapon, or no argument at all''
*cutscene_sync state:string{"mark" | "on" | "off"} - marks a point in a cutscene - cutscene_sync on
*end_cutscene (null) - ends a cutscene - end_cutscene
*fade_in ticks:int - fades the screen in - fade_in 120
*fade_out [r:float | r:int] [g:float | g:int] [b:float | b:int] ticks:int - fades the screen out - fade_out 0 0 0 120
*input on_off:int{0 | 1} - turns input on or off - input 0
*letterbox start_stop:int{0 | 1} - starts or stops letterboxing - letterbox 0

===diary===
*diary_page_unlock page:int - unlocks a specific diary page on the current level

===door===
*door_open door_id:int - opens a door (may not stay open) - door_open 21
*door_close door_id:int - closes a door (may not stay open) - door_close 27
*door_lock door_id:int - locks a door - door_lock 6
*door_unlock door_id:int - unlocks a door - door_unlock 5
*door_jam door_id:int - jams a door in its current state - door_jam 5
*door_unjam door_id:int - unjams a door so characters can open it - door_unjam 8

===env===
*debug_env_anim name:string - draws a line for an environment animation
*env_anim obj_id:int [ obj_id:int] - initiates an environment animation for an object - env_anim 901 906
*env_anim_block obj_id:int [ obj_id:int] - initiates an environment animation: blocks until completed
*env_broken gq_ref:int [gq_endref:int] - computes the number of objects in a range that have all their glass broken - env_broken(3001, 3018);
*env_setanim obj_id:int object_name:string - sets up an animation for an object - env_setanim 52 truckcabstop
*env_setanim_block obj_id:int object_name:string - sets up an animation: blocks until completed
*env_shade gq_ref:int gq_ref:int r:float g:float b:float - sets the shade of a block of objects - env_shade 1500 1501 .9 .8 .9
*env_show gq_ref:int on_off:int{0 | 1} - turns on or off specified parts of the environment - env_show 31 1
*env_texswap gq_start:int tex_name:string - swaps an environment texture - env_texswap 401 PIPE_YELLOW
''tested in level 19 save point 4''

===film===
*chr_playback [ai_name:string | script_id:int] film_name:string [mode:string{"fromhere" | "interp"}] [num_frames:int] - plays back a film
*chr_playback_block [ai_name:string | script_id:int] film_name:string [mode:string{"fromhere" | "interp"}] [num_frames:int] - plays back a film and blocks until complete
*chr_playback_debug film_name:string - dumps stats for a playback film
*playback [ai_name:string | script_id:int] film_name:string [mode:string{"fromhere" | "interp"}] [num_frames:int] - plays back a film - Hangar1_A_Striker_1 hangar1_striker1 interp 30
*playback_block [ai_name:string | script_id:int] film_name:string [mode:string{"fromhere" | "interp"}] [num_frames:int] - plays back a film and blocks until complete - playback_block Start_Friend_1 roll fromhere // playback_block hangar1f_enemy_2 bomber_jump interp 30
*playback_debug film_name:string - dumps stats for a playback film
*sc_focus chr_index:int - sets which character we're authoring for a film

===game (miscellaneous)===
*chr_has_empty_weapon [ai_name:string | script_id:int] - returns if this character is holding a weapon that is empty - chr_has_empty_weapon(char_0)
*chr_has_lsi [ai_name:string | script_id:int] - records that the character has the lsi - chr_has_lsi(0)
*chr_is_player [ai_name:string | script_id:int] - returns if this character is the player - chr_is_player(character)
*crash when:string{"now"} - crashes the game (used for testing error handling)
*did_kill_griffen (null) - returns if we did kill griffen - did_kill_griffen()
*difficulty (null) - returns the difficulty level
*flag_view_prefix prefix:string - view flags with a specific prefix
*hang when:string{"now"} - hangs the game (used for testing error handling)
*killed_griffen murder:bool - sets if we killed griffen - killed_griffen 1
*lose (null) - lose this level - lose
*perf_prefix - sets the perf prefix
*ph_status - xxx
''lists the physics status (collision type) of objects (characters, weapons, doors, etc.) that are currently in use''
*print_state state:int - prints an anim state
*print_type type:int - prints an anim type
*restore_game (null) - restores the game - restore_game
*save_game save_point:int [type:string{"autosave"}] - saves the game - save_game 1 autosave
*splash_screen texture:string - displays a splash screen - splash_screen warehouse_splash_screen
*tr_stop_lookup - bla bla bla
*tr_write_animation anim_name:string file_name:string - varient values are output as hex
*tr_write_collection collection_name:string file_name:string - bla bla bla
*tr_write_lookup file_name:string - bla bla bla
*win (null) - win this level - win

===graphics===
*gl_fog_end_changeto end_val:float [frames:int] - changes the fog end distance smoothly
*gl_fog_start_changeto start_val:float [frames:int] - changes the fog start distance smoothly - gl_fog_start_changeto .995 30
*gs_farclipplane_set plane:float - sets the far clipping plane - gs_farclipplane_set 5000
*gs_fov_set fov_degrees:float - sets the field of view - gs_fov_set 300
*m3_display_list - lists all the display modes
*m3_display_set device_index:int mode_index:int - sets the active display mode
*m3_draw_engine_list - lists all the engines
*m3_engine_set geom_engine:int draw_engine:int - sets the active engine
*m3_geom_engine_list - lists all the engines
*m3_quality_set quality:string - sets the current graphics quality

===input===
*bind input_name:string to:string{"to"} input_function:string - binds an input to a function - bind numpad0 to forward
*lock_keys [key_name:string] - locks keys out - lock_keys keys_walk ''key name strings: keys_reload, keys_hypo, keys_walk, keys_inventory, keys_action, keys_pause, keys_attack, keys_crouch, keys_jump, keys_movement''
''The lock_keys command allows you to enable or disable player keys. Using only lock_keys without a parameter will lock all keys. To unlock a specific set of keys you use the additional parameter, e.g. lock_keys keys_movement will unlock the move keys.''
*unbind input_name:string - removes a binding from a input function - unbind numpad0
*unbindall (null) - removes all bindings - unbindall

===message===
*dmsg astring:string - debugging message - dmsg [b. hello]
''dmsg prints to the subtitle area; the "b" in [b. hello] stands for "blue", setting the color of the word "hello". Available colors: b (blue), c (cyan), g (green), l (lavender), o (orange), r (red), u (umber), y (yellow)''
*dprint astring:string - debugging print
''dprint prints to the console output. Note that calling dprint and dmsg more than once within a single function produces unexpected results; two calls result in one of the dprint/dmsg calls becoming the return value for the function (even if it it's type "void") or sometimes creating a return value of 0, and more than two calls might be ignored.''
*message message:string [timer:int] - sends a message from the subtitle file - message begin_fight 240
*message_remove [message:string] - removes a currently displayed message - message_remove c01_50_23 // message_remove

===movie===
*movie_play name:string - function to start a movie playing

===object===
*obj_create obj_id:int [obj_id:int] - creates a range of objects - obj_create 81 82
*obj_force_draw obj_id:int [obj_id:int] - locks an object as visible - obj_force_draw 501 504
*obj_hide obj_id:int [obj_id:int] - hides an object
*obj_kill obj_id:int [obj_id:int] - kills a range of object - obj_kill 100 104
*obj_shade obj_id:int [obj_id:int] r:float g:float b:float - turns display of an object on or off - obj_shade 801 801 .4 .4 .4
*obj_show obj_id:int [obj_id:int] - shows an object - obj_show 481 481

===objective===
*objective_complete (null) - plays the objective-complete sound
*objective_set page:int [make_silent:string {"silent"}] - sets the current objective page - objective_set(7,silent) // objective_set 3 silent

===particle===
*p3_callevent particle_class:string event_index:int - triggers an event on all P3 particles of a specified class
*p3_count - lists a count of P3 particles
*p3_daodan_disable - disables parts of the daodan shield (for debugging)
*p3_dumpparticles - dump all particles to a text file
*p3_killall - kills all P3 particles
*p3_killnearest - kills the nearest P3 particle
*p3_printtags - prints out all environmental particles with tags
*p3_removedangerous (null) - removes all "dangerous projectile" particles by making their lifetime expire (example mukade energy balls) - p3_removedangerous
*p3_spawn particle_class:string [velocity:float | ] - spawns a new P3 particle
*p3_startall - creates and starts all environmental particles
*p3_stopall - stops all environmental particles
*p3_writeusedparticles - writes all particles used on this level to a text file
*particle - sends a command to environmental particles with a given tag
*particle_temp_kill - kills any temporary particles
*particle_temp_start - starts temporary-particle-creation mode
*particle_temp_stop - stops temporary-particle-creation mode

===player===
*fall_back (null) - makes the player character fall back - fall_back
*fall_front (null) - makes the player character fall front - fall_front
*give_powerup powerup_name:string [amount:int] [character:int] - Gives a powerup to a character - give_powerup ammo
''powerup strings: ammo, cell, hypo, shield (in percent), invis (in frames, -1 = forever), lsi (amount ignored)''
*goto [loc_x:float loc_y:float loc_z:float] - Sets the location of the player character - goto 100 100 100

===powerup===
*chr_givepowerup [ai_name:string | script_id:int] powerup:string [amount:int] - gives a character a powerup - chr_givepowerup 0 ammo 1
*give_powerup powerup_name:string [amount:int] [character:int] - Gives a powerup to a character - give_powerup ammo
''to both above: powerup strings: ammo, cell, hypo, shield (in percent), invis (in frames), lsi (amount ignored)''
*powerup_reset (null) - resets all placed powerups to their starting points - powerup_reset
*powerup_spawn poweruptype:string flag:int - creates a new powerup - powerup_spawn ammo 7042

===reset===
*ai2_reset [reset_player:int] - resets AI as if start of level - ai2_reset
''It reset consoles, and clears characters like you started the level again''
*chr_inv_reset [ai_name:string | script_id:int] - clears a characters inventory - chr_inv_reset ambush_tanker_1a
*cm_reset [maxspeed:float] [maxFocalAccel:float] - resets the camera - cm_reset
*console_reset console_id:int - resets a console to initial state - console_reset 7
*corpse_reset (null) - resets corpses to their initial state - corpse_reset
*powerup_reset (null) - resets all placed powerups to their starting points - powerup_reset
*reset_mechanics (null) - resets all level mechanics (triggers, turrets, consoles, etc...) to initial state - reset_mechanics
*script_reload - reload scripts for a level
*sound_objects_reset (null) - reloads the sounds objects
*trig_reset trigger_id:int - resets a trigger to non-triggered state - trig_reset 91
*trigvolume_reset name:string - reset a trigger volume to its level-load state - trigvolume_reset tv_move4
*turret_reset turret_id:int - resets a turret to initial state
*weapon_reset (null) - resets all unheld weapons to their starting state - weapon_reset

===slowmotion===
*slowmo duration:int - starts the slowmotion timer - slowmo 120

===sound===
*chr_pain [ai_name:string | script_id:int] pain_type:string - forces a character to play a pain sound
''pain type strings: light, medium, heavy, death''
*chr_talk [ai_name:string | script_id:int] sound_name:string pre_pause:int post_pause:int [priority:string | ] - causes a character to play a line of dialogue - chr_talk victim_mansci_1 c02_62_11sci 0 0
*sound_ambient_start name:string [volume:float] - function to start an ambient sound - sound_ambient_start alarm_loop
*sound_ambient_stop name:string - function to stop an ambient sound - sound_ambient_stop alarm_loop
*sound_ambient_volume name:string [volume:float] [time:float] - function to set the volume of a playing ambient sound - sound_ambient_volume alarm_loop .35 1.0
*sound_dialog_play name:string - function to start character dialog playing - sound_dialog_play c00_01_18shinatama
*sound_dialog_play_block name:string - function to start character dialog playing after the current dialog finishes - sound_dialog_play_block c00_01_67shinatama
*sound_dialog_play_interrupt name:string - function to interrupt the current character dialog and play a new one - sound_dialog_play_interrupt c00_01_66shinatama
*sound_impulse_play name:string [volume:float] - function plays an impulse sound - sound_impulse_play glass_big 1.0
''Works with all "imp.oni" files extracted (or created) with OniSplit.''
*sound_list_broken_links - function writes a list of sounds which have broken links to a file
*sound_music_start name:string [volume:float] - function to start music playing - sound_music_start mus_asian 0.75
*sound_music_stop name:string - function to stop playing music - sound_music_stop mus_asian
*sound_music_volume name:string volume:float [time:float] - function to set the volume of playing music - sound_music_volume mus_asian 0.35 1.0
*sound_objects_reset (null) - reloads the sounds objects

===target===
*target_set flag_id:int min_distance:float - Sets the target to the specified flag - target_set(7085,30.00)

===timer===
*timer_start duration:float script:string - starts the countdown timer - timer_start 30 pipe1b
*timer_stop (null) - stops the countdown timer - timer_stop

===triggers (lasers)===
*trig_activate trigger_id:int - activates a trigger - trig_activate 2
*trig_deactivate trigger_id:int - deactivates a trigger - trig_deactivate 2
*trig_hide trigger_id:int - hides a trigger - trig_hide 91
*trig_show trigger_id:int - shows a trigger - trig_show 91
*trig_speed trigger_id:int volume:float - sets a triggers speed - trig_speed 514 .15
*trig_reset trigger_id:int - resets a trigger to non-triggered state - trig_reset 91

===trigger volumes===
*trigvolume_corpse trig_id:int - kills all the corpses inside a trigger volume - trigvolume_corpse 32
*trigvolume_count trig_id:int - counts the number of people in a trigger volume - trigvolume_count(36)
*trigvolume_enable name:string enable:int{0 | 1} [type:string{"all" | "entry" | "inside" | "exit"}] - enable or disable a trigger volume - trigvolume_enable lowroad1 0
*trigvolume_kill trig_id:int - kills all the characters inside a trigger volume - trigvolume_kill 64
*trigvolume_reset name:string - reset a trigger volume to its level-load state - trigvolume_reset tv_move4
*trigvolume_setscript name:string script:string type:string{"entry" | "inside" | "exit"} - set the script to call from a trigger volume
*trigvolume_trigger name:string type:string{"entry" | "inside" | "exit"} [ai_name:string | script_id:int] - fire off a trigger volume

===turret===
*turret_activate turret_id:int - activates a turret
*turret_deactivate turret_id:int - deactivates a turret - turret_deactivate 20
*turret_reset turret_id:int - resets a turret to initial state

===ui (HUD)===
*ui_fill_element element_name:string fill:int - sets part of the HUD to completely filled
*ui_flash_element element_name:string fill:int - sets part of the HUD to flash or not flash - ui_flash_element compass 1 (health)
*ui_show_element element_name:string show:int - shows or hides part of the HUD - ui_show_element left 1
*ui_show_help enable:int - debugging: enables the HUD help overlays - ui_show_help 1

===weapon===
*weapon_reset (null) - resets all unheld weapons to their starting state - weapon_reset
*weapon_spawn weapontype:string flag:int - creates a new weapon - weapon_spawn w3_phr 7045

[[Category:BSL docs]]
[[Category:Scripting tasks]]

File:Demos and Doyle - Regenerating Strikers.jpg

2020-06-25T07:05:34Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

Kojiro

2020-06-24T14:24:23Z

Samer:

Kojiro is a communications trooper, and a prominent minion of Muro; unnamed in the story, the fans have supplied their own name for him.

==Appearances in Game==
*At the end of {{C|3}}, he offers to kill Konoko as Muro's van drives away.
*At the end of {{C|5}} in the airplane besides Muro, where it is revealed that he has been monitoring Konoko, unveiling the existence of Shinatama.
*In {{C|6}} he is seen taking part in the raid on TCTF HQ himself, giving the order to "converge" to "all units" involved.
* In {{C|7}}, standing by Muro as Shinatama is being tortured
* In {{C|8}}, following Muro on his way out of the ACC.

==Playable Character==
He was made into a custom playable character by [[User:Samer|Samer]] and also made part of the [[Saisei Team]]. Mod available [http://oni.bungie.org/community/forum/viewtopic.php?id=1282 here]. 
Moreover, he was added to the game to replace the regular com guy, in the appearances mentioned above, as well as an opponent and joining Muro in the final battle, through the SamMegaPack Conversion Mod available [http://oni.bungie.org/forum/viewtopic.php?id=2467 here].

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

[[Category:Characters]][[Category:Comm Troopers]][[Category:Modding projects]]

File:Kojiro-mod.jpg

2020-06-24T14:17:47Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

Saisei Team

2020-06-24T14:10:30Z

Samer:

The Saisei Team is a concept by [[User:Samer|Samer]] inspired by [[User:Paradox-01|Paradox-01]]'s all grey health regenerating Syndicate team.
Saisei is Japanese for regeneration/ regrowth / rebirth.
The Saisei Team is composed of: [[Kojiro]], [[Regenerating Fury]], [[Regenerating Tanker]] and the 2 Regenerating Striker brothers.

[[File:Saisei1.png|800px]]
[[File:Saisei2.png|800px]]
 

Besides the ability to regenerate health, these characters share a common Emblem designed by Samer. [[File:Saisei Emblem.png|200px|thumb|right|Saisei Emblem]]
The emblem represents a person with arms wide open, similar to the pose these characters take when they health regenerate.
It also represents ascension, the bottom half of the emblem resembles spikes or mutations due to chrysalis. The overall shape also resembles, somewhat, an insect with wings, as reference to the Imago stage of the chrysalis, a term also used for the last stage of an insect's metamorphosis.

[[File:Saisei logos.png|400px|thumb|left|Other appearances of the Saisei Emblem during its creation ]]

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

File:Saisei Emblem.png

2020-06-24T14:09:18Z

Samer:

[[Category:Modding projects]]
[[Category:Logos, icons and symbols]]

Saisei Team

2020-06-24T14:08:37Z

Samer:

The Saisei Team is a concept by [[User:Samer|Samer]] inspired by [[User:Paradox-01|Paradox-01]]'s all grey health regenerating Syndicate team.
Saisei is Japanese for regeneration/ regrowth / rebirth.
The Saisei Team is composed of: [[Kojiro]], [[Regenerating Fury]], [[Regenerating Tanker]] and the 2 Regenerating Strikers brothers.

[[File:Saisei1.png|800px]]
[[File:Saisei2.png|800px]]
 

Besides the ability to regenerate health, these characters share a common Emblem designed by Samer. [[File:Saisei Emblem.png|200px|thumb|right|Saisei Emblem]]
The emblem represents a person with arms wide open, similar to the pose these characters take when they health regenerate.
It also represents ascension, the bottom half of the emblem resembles spikes or mutations due to chrysalis. The overall shape also resembles, somewhat, an insect with wings, as reference to the Imago stage of the chrysalis, a term also used for the last stage of an insect's metamorphosis.

[[File:Saisei logos.png|400px|thumb|left|Other appearances of the Saisei Emblem during its creation ]]

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

File:Saisei logos.png

2020-06-24T13:59:39Z

Samer: Category:Modding projects Category:Logos, icons and symbols

== Summary ==
[[Category:Modding projects]]
[[Category:Logos, icons and symbols]]

File:Saisei Emblem.png

2020-06-24T13:59:02Z

Samer: Category:Modding projects Category:Logos, icons and symbols

== Summary ==
[[Category:Modding projects]]
[[Category:Logos, icons and symbols]]

File:Saisei2.png

2020-06-24T13:52:10Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

File:Saisei1.png

2020-06-24T13:45:49Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

Anniversary Edition/Core

2020-06-23T12:09:43Z

Samer:

These are the fixes and patches that are automatically installed by the [[AE]].

{|align=left border=1 cellspacing=0 color=black cellpadding=3 style="text-align:center"
!Package
!Name
!Ver.
!Description
!width=330|Preview
|-
|[http://mods.oni2.net/node/227 0]
|[[OniSplit]]
|0.9.95.0
|Allows the AE to apply mods to Oni's game data.
|
|-
|[http://mods.oni2.net/node/265 1]
|[[XmlTools]]
|2.0
|Allows the AE to apply patch mods in Oni's game data.
|
|-
|[http://mods.oni2.net/node/304 2]
|XmlTools Dependencies
|1.1
|The framework needed for XmlTools to run.
|
|-
|[http://mods.oni2.net/node/269 7]
|AE Read-Me
|2015-03
|A shorter version of the documentation found on this wiki.
|
|-
|[http://mods.oni2.net/node/231 10]
|Oni game app (Windows)
|1.0
|Provides a standard version of Oni.exe for the Daodan DLL to modify.
|[[Image:Oni icon-original 32px.png]]
|-
|[http://mods.oni2.net/node/232 11]
|[[AE:FERAL|Oni game app (Macs)]]
|1.2.1
|The Feral build of Oni.app for Intel Macs.
|[[Image:Oni icon-Mac 32px.png]]
|-
|[http://mods.oni2.net/node/233 20]
|[[Daodan DLL|Daodan DLL (Windows)]]
|4.0
|Patches Oni.exe. See link for details.
|[[Image:DLL icon-WinVista.png]]
|-
|[http://mods.oni2.net/node/273 50]
|Menu Fixes
|1.1
|Labels the Main Menu with "Anniversary Edition", fixes the backwards "Invert Mouse" option label, corrects an out-of-order diary page, and corrects the spelling of "effect" in a restart dialog.
|[[Image:AE_Main_Menu.jpg|256px]]
|-
|[http://mods.oni2.net/node/268 2000]
|Globalization Fixes for Characters
|1.2
|This fixes incorrect occurrences of certain character classes, which are a side-effect of the globalization process by which the AE makes all classes available on all levels, and prevents TCTF from attacking civilians in Ch. 6.
|
|-
|[http://mods.oni2.net/node/262 2200]
|Custom Character Variants & TRAM Fixes
|1.1
|Allows for new character classes to be referenced by mods without crashing if those characters are not installed. In addition, applies fixes to some missing\bugged vanilla TRAMS. (Adds Hitjewels and HitfootOuch hittype missing animations, Allows VDG-stunned throws for all characters).
|
|-
|[http://mods.oni2.net/node/284 2400]
|[[AE:DeLorean|Airport Vehicle Fix]]
|1
|Fixes an improperly-textured sports car that pulls away from the Airport suspiciously in the beginning of Chapter 4.
|[[Image:Car960 fix.jpg|256px]]
|-
|[http://mods.oni2.net/node/285 3000]
|Bomber Fix
|1.0
|Makes AI aware of the danger represented by a ticking Mad Bomber so they can (try to) evade the explosion.
|
|-
|[http://mods.oni2.net/node/270 4000]
|Widescreen Fixes
|1.11
|Corrects issues that show up in 16:10 and 16:9 resolutions, which Bungie never thought you'd see back when 4:3 was the standard. Hover over images for more info.
|[[Image:Widescreen fix-Ch02.jpg|256px|In the intro to Chapter 2, a nearby wall was blocking the camera at the beginning.]] [[Image:Widescreen fix-Ch11.jpg|256px|In the intro to Chapter 11, all the photos that were supposed to be hidden off-camera were visible.]] [[Image:Widescreen fix-Ch14.jpg|256px|In the intro to Chapter 14, Konoko was visible on the ground before she falls from the sky.]]
|-
|[http://mods.oni2.net/node/266 5000]
|Unlock All Moves
|1.3
|Makes all of Konoko's attacks available from Chapter 1 onward.
|
|-
|[http://mods.oni2.net/node/234 5100]
|Vanilla BSL
|1.1
|Simply supplies the original, unaltered level scripts to help guarantee that mods are running on consistent scripting.
|
|-
|[http://mods.oni2.net/node/282 6000]
|Missing Sounds
|1.0
|Restores sounds to Oni that were missing upon its release (only one sound so far, the gears at the end of Chapter 12).
|[[Image:Gears with missing ambient sound.jpg|256px]]
|}

[[Category:Anniversary Edition]]

XML:TRAM

2020-06-22T09:04:57Z

Samer:

{{XML_File_Header | type=TRAM | prev=TRAC | next=TRAS | name=Totoro Animation }}

{{TOCfloat|side=right}}

TRAM files - animation data for characters - are basically made of three chunks.

* Meta data or "header": animation type, state, flags, particle, sounds, etc.
* Animation data: pelvis heights, pelvis velocities, bone rotations
* Attack data: damage, self-damage, extends (danger zones for AI awareness) and throws

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.

===Decision path of animation lookup===
* At 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 child TRAC override those of the parent if their combination of state, type and variant is excatly the same.
* On the other hand child TRAC often miss some anims. For example elite striker don't have their own run anims, they must and will use the parent anims of normal strikers. The game was here designed to save resources. See [[XML:TRAC|TRAC]] page for details.
* A character possesses always one 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 played at a given moment.
* It follows the full decision path:
** anim '''state''' check
** event (user input / engine input for AI) -> [[XML_talk:StNA|context check]] -> anim '''type''' check
** anim '''variant''' check
** TRAC '''weight''' check

One detailed example:

Let's say we shapeshifted to an ninja ONCC, are in state Standing and hit the action key for taunt.

The engine recognizes the context (an hostile character to interact with) and looks up anims of type Taunt.

Since we are in combat mode the following anim must be of variant Combat if possible.

Those lookups all boile down to two valid anims, NINCOMtaunt1 and NINCOMtaunt2.

If there are multiple anims avaible at this point the engine has to pick one of them randomly.

However, NINCOMtaunt1 has a TRAC Weight (probability) of 100 while NINCOMtaunt2 has a TRAC Weight value is just 5.

Chances are quite high we will not see the Moon Walk taunt.

Keep in mind that if the engine cannot find an anim of a specific variant it will fall back to use the non-variant anim instead.

Confused how Weights work? Apparently, that Weight value is only one part of the equation - otherwise NINCOMtaunt2 would never execute.

If there is only one anim to chose from, it will always play no matter what Weight, even if it is zero.

As for multiple anim being a valid choice the calculation seems to be this for an individual anim: weight / sum of all weight.

For NINCOMtaunt2 it means 5 / 105 = 0,047 (4,7%).

===List of tags, types, and flags===
Use the search function of your web 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]]. Pool of valid TRAM (animations a character can chose from) is build from TRAC files registered in ONCC. Most of the anim types are associated with player inputs.
|-
| <AimingType>
| flag
| Look them up over [[XML:StNA#animation_types|HERE]]. Pool of valid TRAM, and therefor TRAS, (animations a character can chose from) is build from TRSC files registered in 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, tag will be simply "<Varient />", such as for non-combat animations. Otherwise 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 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 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 8 frames long; 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 with rotations are less noticeable, interpolations of different positions can cause an additional drift (i.e. sliding).

This was especially observed for transitions of 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 better don't use interpolation. Just let the start and end frames have same positions and rotation values as the idle. Interpolations should always be considered as ''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 single 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 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
|
: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. Damage from particles and fall damage still hurt.
:BlockHigh
::While playing this animation, the player is invulnerable to high or undefined attacks within some arc in front of him. 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 attacks.
:Attack
::Animations with an attack part have this turned on. Uncertain what it does, but it may enable the melee soft-lock (where the character turns a bit during the animation to face a nearby enemy).
:DropWeapon
::If the player is armed, he drops his weapon when this animation plays.
:InAir
::Something to do with jumps; not investigated.
:Atomic
::The whole animation must be played; player cannot interrupt it once it starts.
:NoTurn
:::Player cannot turn by mouse while performing this animation.
:AttackForward
::Unknown, but it looks like this is rough info for the AI about where an attack is aiming, from the player's point of view.
: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
::Unknown, but throws use it.
: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 the hurt 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
::It appears this flag was used 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 them 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
::Unknown.
:DisableShield
::If the player has an active supershield (chr_super "name" 1), this forces him to disable it (chr_super "name" 0)
:NoAIPickup
::AIs are not permitted to pick up items with this animation.
|-
| <Atomic>
| parent tag
| 
|-
| <Start>
| int16
|
|-
| <End>
| int16
|
|-
| <Invulnerable>
| parent tag
| Character will not take melee damge during a timeframe defined by 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
|
|-
|valign="top"| <Soft>
|valign="top"| int16
| Player cannot make new inputs during this pause unless this animation is followed by a followup combo animation defined by <DirectAnimations><Link>.
: Examples:
: COMcomb_p, (no pause) COMcomb_p_p
: COMcomb_p, (pause) COMcomb_k
Combos ignore <Interpolation><End>.
|-
| <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)

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 accelerationsat start and end. By default, animations without specified Shortcut interpolation give about 8 frames of interpolation. For moves starting or ending in idle better don't use interpolation. Just let the start and end frames have same positions and rotation values as the idle. Interpolations should always be considered as ''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 animation 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"|
|
:None
:Forward
:Backward
:Left
:Right
|-
| <Vocalization>
| int
| Id of one of the [[XML:SNDD#step_1:_preparing_the_TRAM|SoundConstances in ONCC]]
|-
| <ActionFrame>
| int
| Frame number for spacial events associated with this animation: weapon theft in disarms, weapon holster, Mukade actually teleporting, items getting handed over to player. "Give me that hypo!" Yada yada.
|-
| <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 number exceeds frame count of animation the particle will simply die with end of 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
|
|-
| <End>
| int16
|
|-
| <Lifetime>
| int8
|
|-
| <Alpha>
| int8
|
|-
| <Interval>
| int8
|
|-
| <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 only the change of 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 those has no effect in game.'''
|-
| <X>
| int16
|
|-
| <Z>
| int16
|
|-
| <Positions>
| parent tag
|
|-
| <Position>
| float
| seems to be unused (also 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:
*X - Side axis. Negative values move the target to the right, positive values move the target to the left.
*Y - Height axis. Negative values move the target downwards, but in case of collision due to too low negative value, it will not make the target go below the surface. Positive values make the target go upwards - if the value is too big, the target will teleport above, and then immediately start falling, interrupting the target animation.
*Z - Forward axis. Negative values move the target backwards, positive values move the target forward.
|-
| <Angle>
| float
|
|-
| <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 parent TRAC.
|-
|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" can also be omitted)
|-
| <SelfDamage>
| parent tag
| "<SelfDamage />" if unused.
|-
| <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 [http://oni.bungie.org/community/forum/viewtopic.php?pid=39787#p39787 hit by both of them].
|-
| <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
|
: Unblockable
: Low - Target of attack needs to crouch in order to block this attack.
: High - Blocker needs to stand; if Low and High are set then blocker can block from both standing and crouching positions.
: HalfDamage - Blocker receives half of the normal damage.
|-
| <Knockback>
| float
| Target gets "knockback"ed by this amount.
|-
| <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 for how long the target should remain in his "hit" animation state when he gets hit.
|-
| <StunLength>
| int16
| Number in frames for how long the target should remain in his blocking animation when he blocks the attack.
|-
| <StaggerLength>
| int16
| Number of frames for how long 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 XML.
|-
| <Extent>
| parent tag
| One tag per frame.
|-
| <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 so that the AI has a chance 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]]

When you start '''[[Vago_(tool)|Vago]]''', the "General" tab should be open by default. If not, click on it. Then follow these five easy steps.


'''Step 1:''' Select "ONI" as input format ("From").

'''Step 2:''' Select "XML" as output format ("To").

'''Step 3:''' Check "Another TRAM" to chose a character animation file.

'''Step 4:''' Click "Add" button to choose an ONCC file.

'''Step 5:''' 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 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===
====XSI====
You can load the DAE file into a compatible editor. So far, the community's favorite is {{ModTool}}.
* 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 is also intended for the animations. This makes sure the pelvis height will match and feet will not float in the air or go through the ground.
* First frame and last frame 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 been 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 [[wikipedia:Gimbal_lock|gimbal lock]].

See also our [http://oni.bungie.org/forum/viewtopic.php?id=1433 OCF thread].

====Blender====
Theoretical possible. Very difficult in practice and we don't have a tutorial on this one.

===Import===
onisplit -create output_path path_to\TRAMname.xml

==Additonal details==
===Speeding up existing animations===
s10k has created a XmlTools patch that allow the speedup of any existing TRAM (by removing frames). More information and download [http://mods.oni2.net/node/354 here.]

===Attacks===
====Extents and XML====
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> minimal 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 (again, see the MELE page).
::The number of <Extent>s is equal to the number of attack frames: <End> minus <Start> plus one (because start frame counts too). For example, for TRAMKONCOMkick_low1: <End>30</End> minus <Start>22</Start> plus one = 9 <Extent>s.

:These extents are pretty impossible to guess, so leave them alone until Neo comes up with extent computation (probably from attack bones and bone rotations). However, always add at least one set of component tags, because those Length, MinY and MaxY components will be taken as the longest extent, the highest Y value, and the lowest Y value. Without those, a character won't react to this attack.

*'''<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.

====Adding extents to an existing animation====
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 representative size for 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 keystroke or mouse clicks for combos is hardcoded.

To assign an animation for a specific combo attack you set corresponding value in <Lookup><Type>.

Setting a value in <Link> of '''<DirectAnimations>''' will do two things:
# It will increase the time for player input, meaning the next animation can be executed more easily. (In vanilla 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 combos===
For short '''JF combos''' or '''JF anims'''. Created by Delano, inspired by the game series Tekken.

JF means you have to press certain keys (w + k or w + p) at the exact time, which is more difficult than it might sound.

Package 54000 has basically a collection of new state cycles.

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

===Throws===
Throw target animations are registered in the TRAC of the throw initiator (AKA the throw source). Target animations are forced onto the other character, removing the need to have that animation in the target's TRAC. Throw target (TRAM*tgt) animations can cover only up to 256 (0-255) frames.

====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.

=====Excel macro=====
Needs update.

[[Image:Animation_macro_v4.png|right|thumb]]
* [http://dl.dropbox.com/u/139715/OniGalore/TRAM_macro.zip Here's the macro] (for all TRAMs except overlays). [http://youtu.be/wxzJ8ahjP8k Demo vid here]. Usage:
* Put your files into the "input_and_output" folder.
* Disable macro security if you don't want to have to click on the macro options button every time.
* Close other worksheets before you run the macro.
* If you are not afraid of VBA code, you can enter the dev environment by hitting Alt+F11. If you want to extend the attack library with more screenshots and settings, search for: "LibraryThrows", " LibraryAttack", "Picture", and "CBAttackHelp.AddItem".

===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. These could be reintegrated/recycled/whatever....

'''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 was placing something (bomb?) and then running away
* KONOKOlev4_undress: from an aborted clothes-changing cutscene
* KONOKOlev16_bomb: planting a bomb
* KONCOMsuper_kick: now used in OTA scripts (mod) as spawn event, and by custom made character [[Shinatama Bot]]
* KONCOMsuper_punch: KONCOMpunch_heavy but without the shouted attack name, has HalfDamage flag, and does 10 less damage in its first attack part
* 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: Striker checking his his gun and communicating with an ally (another unused alertness animation)
* THUGlev1_direct: Thug probably directing a truck driver

'''From modders'''

The following files are available in DAE (and maybe .oni format).

[[Image:female_stun.jpg|right|thumb|charA and charB performing stun animations]]

* [https://www.dropbox.com/s/5d6aki276ryb61y/REDCOMjump_fw_crouch--double_flip--dae.zip?dl=0 Fury double flip] (.dae)
* [https://www.dropbox.com/s/dww2hf1yj6e7wqa/KONenter_prone_mode--oni_and_dae.zip?dl=0 Konoko enters prone mode] (.dae + .oni)
* [https://www.dropbox.com/s/3llicjdxbva836p/KONprone_getup--dae.zip?dl=0 Konoko leaves prone mode] (.dae)
** These are artifacts of Paradox's work on his [http://mods.oni2.net/node/119 Prone Mode] mod.
* [https://www.dropbox.com/s/luf7ayqikcuupo7/female_stun--dae.zip?dl=0 Female stun (throw pair)] (.dae)
** Needs to be slowed down by adding more frames.

===FX - special effects===
If the scene is overloaded by particle - including motion blur - these effects will stop to be rendered.

So, don't overuse effects.

====Adding colorful 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====
...

{{XML}}

XML:TRAM

2020-06-22T08:59:59Z

Samer:

{{XML_File_Header | type=TRAM | prev=TRAC | next=TRAS | name=Totoro Animation }}

{{TOCfloat|side=right}}

TRAM files - animation data for characters - are basically made of three chunks.

* Meta data or "header": animation type, state, flags, particle, sounds, etc.
* Animation data: pelvis heights, pelvis velocities, bone rotations
* Attack data: damage, self-damage, extends (danger zones for AI awareness) and throws

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.

===Decision path of animation lookup===
* At 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 child TRAC override those of the parent if their combination of state, type and variant is excatly the same.
* On the other hand child TRAC often miss some anims. For example elite striker don't have their own run anims, they must and will use the parent anims of normal strikers. The game was here designed to save resources. See [[XML:TRAC|TRAC]] page for details.
* A character possesses always one 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 played at a given moment.
* It follows the full decision path:
** anim '''state''' check
** event (user input / engine input for AI) -> [[XML_talk:StNA|context check]] -> anim '''type''' check
** anim '''variant''' check
** TRAC '''weight''' check

One detailed example:

Let's say we shapeshifted to an ninja ONCC, are in state Standing and hit the action key for taunt.

The engine recognizes the context (an hostile character to interact with) and looks up anims of type Taunt.

Since we are in combat mode the following anim must be of variant Combat if possible.

Those lookups all boile down to two valid anims, NINCOMtaunt1 and NINCOMtaunt2.

If there are multiple anims avaible at this point the engine has to pick one of them randomly.

However, NINCOMtaunt1 has a TRAC Weight (probability) of 100 while NINCOMtaunt2 has a TRAC Weight value is just 5.

Chances are quite high we will not see the Moon Walk taunt.

Keep in mind that if the engine cannot find an anim of a specific variant it will fall back to use the non-variant anim instead.

Confused how Weights work? Apparently, that Weight value is only one part of the equation - otherwise NINCOMtaunt2 would never execute.

If there is only one anim to chose from, it will always play no matter what Weight, even if it is zero.

As for multiple anim being a valid choice the calculation seems to be this for an individual anim: weight / sum of all weight.

For NINCOMtaunt2 it means 5 / 105 = 0,047 (4,7%).

===List of tags, types, and flags===
Use the search function of your web 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]]. Pool of valid TRAM (animations a character can chose from) is build from TRAC files registered in ONCC. Most of the anim types are associated with player inputs.
|-
| <AimingType>
| flag
| Look them up over [[XML:StNA#animation_types|HERE]]. Pool of valid TRAM, and therefor TRAS, (animations a character can chose from) is build from TRSC files registered in 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, tag will be simply "<Varient />", such as for non-combat animations. Otherwise 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 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 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 8 frames long; 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 with rotations are less noticeable, interpolations of different positions can cause an additional drift (i.e. sliding).

This was especially observed for transitions of 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 better don't use interpolation. Just let the start and end frames have same positions and rotation values as the idle. Interpolations should always be considered as ''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 single 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 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
|
: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. Damage from particles and fall damage still hurt.
:BlockHigh
::While playing this animation, the player is invulnerable to high or undefined attacks within some arc in front of him. 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 attacks.
:Attack
::Animations with an attack part have this turned on. Uncertain what it does, but it may enable the melee soft-lock (where the character turns a bit during the animation to face a nearby enemy).
:DropWeapon
::If the player is armed, he drops his weapon when this animation plays.
:InAir
::Something to do with jumps; not investigated.
:Atomic
::The whole animation must be played; player cannot interrupt it once it starts.
:NoTurn
:::Player cannot turn by mouse while performing this animation.
:AttackForward
::Unknown, but it looks like this is rough info for the AI about where an attack is aiming, from the player's point of view.
: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
::Unknown, but throws use it.
: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 the hurt 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
::It appears this flag was used 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 them 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
::Unknown.
:DisableShield
::If the player has an active supershield (chr_super "name" 1), this forces him to disable it (chr_super "name" 0)
:NoAIPickup
::AIs are not permitted to pick up items with this animation.
|-
| <Atomic>
| parent tag
| 
|-
| <Start>
| int16
|
|-
| <End>
| int16
|
|-
| <Invulnerable>
| parent tag
| Character will not take melee damge during a timeframe defined by 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
|
|-
|valign="top"| <Soft>
|valign="top"| int16
| Player cannot make new inputs during this pause unless this animation is followed by a followup combo animation defined by <DirectAnimations><Link>.
: Examples:
: COMcomb_p, (no pause) COMcomb_p_p
: COMcomb_p, (pause) COMcomb_k
Combos ignore <Interpolation><End>.
|-
| <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)

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 accelerationsat start and end. By default, animations without specified Shortcut interpolation give about 8 frames of interpolation. For moves starting or ending in idle better don't use interpolation. Just let the start and end frames have same positions and rotation values as the idle. Interpolations should always be considered as ''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 animation 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"|
|
:None
:Forward
:Backward
:Left
:Right
|-
| <Vocalization>
| int
| Id of one of the [[XML:SNDD#step_1:_preparing_the_TRAM|SoundConstances in ONCC]]
|-
| <ActionFrame>
| int
| Frame number for spacial events associated with this animation: weapon theft in disarms, weapon holster, Mukade actually teleporting, items getting handed over to player. "Give me that hypo!" Yada yada.
|-
| <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 number exceeds frame count of animation the particle will simply die with end of 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
|
|-
| <End>
| int16
|
|-
| <Lifetime>
| int8
|
|-
| <Alpha>
| int8
|
|-
| <Interval>
| int8
|
|-
| <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 only the change of 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 those has no effect in game.'''
|-
| <X>
| int16
|
|-
| <Z>
| int16
|
|-
| <Positions>
| parent tag
|
|-
| <Position>
| float
| seems to be unused (also 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:
*X - Side axis. Negative values move the target to the right, positive values move the target to the left.
*Y - Height axis. Negative values move the target downwards, but in case of collision due to too low negative value, it will not make the target go below the surface. Positive values make the target go upwards - if the value is too big, the target will teleport above, and then immediately start falling, interrupting the target animation.
*Z - Forward axis. Negative values move the target backwards, positive values move the target forward.
|-
| <Angle>
| float
|
|-
| <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 parent TRAC.
|-
|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" can also be omitted)
|-
| <SelfDamage>
| parent tag
| "<SelfDamage />" if unused.
|-
| <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 [http://oni.bungie.org/community/forum/viewtopic.php?pid=39787#p39787 hit by both of them].
|-
| <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
|
: Unblockable
: Low - Target of attack needs to crouch in order to block this attack.
: High - Blocker needs to stand; if Low and High are set then blocker can block from both standing and crouching positions.
: HalfDamage - Blocker receives half of the normal damage.
|-
| <Knockback>
| float
| Target gets "knockback"ed by this amount.
|-
| <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 for how long the target should remain in his "hit" animation state when he gets hit.
|-
| <StunLength>
| int16
| Number in frames for how long the target should remain in his blocking animation when he blocks the attack.
|-
| <StaggerLength>
| int16
| Number of frames for how long 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 XML.
|-
| <Extent>
| parent tag
| One tag per frame.
|-
| <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 so that the AI has a chance 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]]

When you start '''[[Vago_(tool)|Vago]]''', the "General" tab should be open by default. If not, click on it. Then follow these five easy steps.


'''Step 1:''' Select "ONI" as input format ("From").

'''Step 2:''' Select "XML" as output format ("To").

'''Step 3:''' Check "Another TRAM" to chose a character animation file.

'''Step 4:''' Click "Add" button to choose an ONCC file.

'''Step 5:''' 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 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===
====XSI====
You can load the DAE file into a compatible editor. So far, the community's favorite is {{ModTool}}.
* 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 is also intended for the animations. This makes sure the pelvis height will match and feet will not float in the air or go through the ground.
* First frame and last frame 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 been 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 [[wikipedia:Gimbal_lock|gimbal lock]].

See also our [http://oni.bungie.org/forum/viewtopic.php?id=1433 OCF thread].

====Blender====
Theoretical possible. Very difficult in practice and we don't have a tutorial on this one.

===Import===
onisplit -create output_path path_to\TRAMname.xml

==Additonal details==
===Speeding up existing animations===
s10k has created a XmlTools patch that allow the speedup of any existing TRAM (by removing frames). More information and download [http://mods.oni2.net/node/354 here.]

===Attacks===
====Extents and XML====
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> minimal 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 (again, see the MELE page).
::The number of <Extent>s is equal to the number of attack frames: <End> minus <Start> plus one (because start frame counts too). For example, for TRAMKONCOMkick_low1: <End>30</End> minus <Start>22</Start> plus one = 9 <Extent>s.

:These extents are pretty impossible to guess, so leave them alone until Neo comes up with extent computation (probably from attack bones and bone rotations). However, always add at least one set of component tags, because those Length, MinY and MaxY components will be taken as the longest extent, the highest Y value, and the lowest Y value. Without those, a character won't react to this attack.

*'''<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.

====Adding extents to an existing animation====
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 representative size for 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 keystroke or mouse clicks for combos is hardcoded.

To assign an animation for a specific combo attack you set corresponding value in <Lookup><Type>.

Setting a value in <Link> of '''<DirectAnimations>''' will do two things:
# It will increase the time for player input, meaning the next animation can be executed more easily. (In vanilla 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 combos===
For short '''JF combos''' or '''JF anims'''. Created by Delano, inspired by the game series Tekken.

JF means you have to press certain keys (w + k or w + p) at the exact time, which is more difficult than it might sound.

Package 54000 has basically a collection of new state cycles.

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

===Throws===
Throw target animations are registered in the TRAC of the throw initiator (AKA the throw source). Target animations are forced onto the other character, removing the need to have that animation in the target's TRAC. Throw target (TRAM*tgt) animations can cover only up to 256 (0-255) frames.

====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.

=====Excel macro=====
Needs update.

[[Image:Animation_macro_v4.png|right|thumb]]
* [http://dl.dropbox.com/u/139715/OniGalore/TRAM_macro.zip Here's the macro] (for all TRAMs except overlays). [http://youtu.be/wxzJ8ahjP8k Demo vid here]. Usage:
* Put your files into the "input_and_output" folder.
* Disable macro security if you don't want to have to click on the macro options button every time.
* Close other worksheets before you run the macro.
* If you are not afraid of VBA code, you can enter the dev environment by hitting Alt+F11. If you want to extend the attack library with more screenshots and settings, search for: "LibraryThrows", " LibraryAttack", "Picture", and "CBAttackHelp.AddItem".

===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. These could be reintegrated/recycled/whatever....

'''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 was placing something (bomb?) and then running away
* KONOKOlev4_undress: from an aborted clothes-changing cutscene
* KONOKOlev16_bomb: planting a bomb
* KONCOMsuper_kick: now used in OTA scripts (mod) as spawn event
* KONCOMsuper_punch: KONCOMpunch_heavy but without the shouted attack name, has HalfDamage flag, and does 10 less damage in its first attack part
* 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: Striker checking his his gun and communicating with an ally (another unused alertness animation)
* THUGlev1_direct: Thug probably directing a truck driver

'''From modders'''

The following files are available in DAE (and maybe .oni format).

[[Image:female_stun.jpg|right|thumb|charA and charB performing stun animations]]

* [https://www.dropbox.com/s/5d6aki276ryb61y/REDCOMjump_fw_crouch--double_flip--dae.zip?dl=0 Fury double flip] (.dae)
* [https://www.dropbox.com/s/dww2hf1yj6e7wqa/KONenter_prone_mode--oni_and_dae.zip?dl=0 Konoko enters prone mode] (.dae + .oni)
* [https://www.dropbox.com/s/3llicjdxbva836p/KONprone_getup--dae.zip?dl=0 Konoko leaves prone mode] (.dae)
** These are artifacts of Paradox's work on his [http://mods.oni2.net/node/119 Prone Mode] mod.
* [https://www.dropbox.com/s/luf7ayqikcuupo7/female_stun--dae.zip?dl=0 Female stun (throw pair)] (.dae)
** Needs to be slowed down by adding more frames.

===FX - special effects===
If the scene is overloaded by particle - including motion blur - these effects will stop to be rendered.

So, don't overuse effects.

====Adding colorful 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====
...

{{XML}}

Regenerating Fury

2020-06-21T10:02:16Z

Samer:

Regenerating Fury is a custom character by [[User:Samer|Samer]]. 
She is a unique looking fury that can health regenerate like [[Barabas]].. 
Initially, the concept of a health regenerating fury is by [[User:Paradox-01|Paradox-01]]. She was called Grey Fury in her earlier versions.
 
She is the leader of the furies who was given a Chrysalis. 
She is part of the [[Saisei Team]] along with [[Kojiro]] and [[Regenerating Tanker]]
 
The mod can be found [http://oni.bungie.org/community/forum/viewtopic.php?id=1317 here]
 

[[File:Regenerating Fury.jpg|800px]]

[[Category:Furies]][[Category:Modding projects]]

File:Regenerating Fury.jpg

2020-06-21T09:57:26Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

Modifying textures

2020-06-21T07:47:31Z

Samer: added the fourth envmap that is used for Konoko's armor

Here are some brief instructions on how to modify the texture maps. You might want make new skins for a character or even a new outfit for Konoko!

'''Extract TXMP''' (Texture maps)
:1) Make a folder for the textures to go into ("tex_folder" below).
:2) You will need to 'cd' (change directory in the terminal) to AE/AEInstaller/vanilla/.
:3) To extract all the TXMPs, use the following command:
:onisplit -extract:png tex_folder level0_Final.dat

:For example:
:PC users: onisplit -extract:png tex_folder level0_Final.dat (Or you can use -extract:tga to get the files in Targa format)
:Mac users: mono onisplit.exe -extract:png tex_folder level0_Final.dat
:3) Now all the TXMPs from Oni (over 2,000) will be located in the Oni/TXMPfiles

'''Modify TXMP'''
:1) Currently, many of Oni's texture maps are 64x64, or 128x128; unmodded, Oni supports textures up to 256x256, but the current patched version of Oni for Windows supports 512x512, and the patched version of Oni for macOS supports up to 1024x1024.
:2) Use your favorite graphic editor to make your changes.

'''Create TXMP*.oni files'''
For most image files you can use the following command:
:PC: onisplit -create:txmp destination_directory options source_image_file
:Mac: mono onisplit.exe -create:txmp destination_directory options source_image_file

: The source_image_file can be dds or tga. "Color indexed" and "black and white" tga files are not supported currently. Other image file formats (png, jpg, bmp, tif) may work depending on Mono/.NET support for them. onisplit will automatically prepend TXMP to the output file name if the source file name does not start with TXMP already.

:Options can be
:-nouwrap - set the "U wrapping disabled" flag
:-nowwrap - set the "V wrapping disabled" flag
:-format:bgr555 (or dxt1) for most of the stuff
:-format:bgr32 for skyboxes
:-format:bgra4444 for transparent/reflective stuff (in a couple of places bgra5551 is used but probably it's not big deal if bgra4444 is used instead)
:-genmipmaps - generate mipmaps if they are not already present in the source file and if the source file is not dxt1 compressed
:-envmap - envmap used for reflectivity

:Here is an example
:PC: onsplit -create:txmp dest_dir -format:bgr555 -genmipmaps TXMPSTR_EASY_1%2FSTRbicepR.tga
:Mac: mono onisplit.exe -create:txmp dest_dir -format:bgr555 -genmipmaps TXMPSTR_EASY_1%2FSTRbicepR.tga

:To batch process a folder you can use this command;
:PC: onisplit -create:txmp dest_dir -format:bgr555 -genmipmaps folder_of_images\*.tga
:Mac: mono onisplit.exe -create:txmp dest_dir -format:bgr555 -genmipmaps folder_of_images/*.tga

:For image files that use an envmap (Such as Striker armor, Ninja armor, Elite armor, Konoko's face, weapons), you will need to include the name of the envmap:
:PC: onisplit -create:txmp dest_dir -format:bgra4444 -genmipmaps -envmap:envmapname imagefile.tga
:Mac: mono onisplit.exe -create:txmp dest_dir -format:bgra4444 -genmipmaps -envmap:envmapname imagefile.tga

:3) Once you have created the TXMP*.oni file, you will need to put it in the level0_Final folder and then recompile the level.

:4) Play the game and see how your new texture maps look.

'''TXMP & XML'''
: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.
:* options for <Flags> (more than one are separated by a double space) : None HasMipMaps DisableUWrap DisableVWrap AnimUseLocalTime AnimBackToBack AnimRandom AnimIgnoreGlobalTime ShieldEffect InvisibilityEffect DaodanEffect
:* options for <Format> : ARGB4444 / RGB555 / ARGB5551 / RGB888 / DXT1
: 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 width and height of the texture, this is obtained from the tga file. If you resize the tga file the texture will be resized too.

'''Reflective textures'''

:Keep in mind, Oni simulates reflectivity using textures and alpha channels.

:To see how a reflective texture is made, extract TXMPSTR_HARD_1%2FSTRchest.oni as XML. You will get a TGA and XML file.
:Open the TGA file in a photo editor and it has an alpha channel. The alpha channel determines what part of the texture is reflective. Black in the alpha channel means no reflectivity, gray to white is increasing amounts of reflectivity.

:Now in the XML file, there are 2 properties you will be concerned with:
:<Format>ARGB4444</Format>
:<EnvMap>TXMPstrikerarmor</EnvMap>

:The <Format> is how the texture will be saved. In this case, the striker's chest texture was originally saved with an alpha channel. Now there are 3 formats that can have an alpha channel:

:ARGB4444 = 4,096 colors, alpha 16 colors
:ARGB5551 = 32,768 colors, alpha 2 colors
:ARGB8888 = 16,777,216 colors, alpha 256 colors (Note: this one requires the Oni engine to be patched and not many have the patched version)

:The <EnvMap> refers to what texture is used to simulate reflectivity. There are 4 envmap files that are used for characters:
:TXMPstrikerarmor
:TXMPenvksface
:TXMPenvksarmor
:TXMPSUPER_REFLECT

:You might want to extract this file as xml to see its properties.

:Once you make your texture that has an alpha channel, use the XML file to convert it back to .oni file.
(from here: http://oni.bungie.org/community/forum/viewtopic.php?pid=19297#p19297, to be edited and completed)

[[Category:Modding tutorials]]

Shinatama Evolved

2020-06-19T01:51:31Z

Samer:

'''Shinatama Bot''' is a custom playable character developed by [[User:Samer|Samer]]. 
The idea is [[Shinatama]] got rebuilt/resurrected into a more combat-able 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 2 outfits and custom move set and is available [http://oni.bungie.org/community/forum/viewtopic.php?id=1240 here]

https://lh6.googleusercontent.com/-U1XHpMAAxGk/TyUAVoIWCUI/AAAAAAAAB8o/JXLVWO5CvzE/s800/shin.jpg 

*The second outfit is based on DarkLitria's [[:Image:Shini3.png|sketch]]
 
[[Category:Characters]][[Category:Modding projects]]

Regenerating Tanker

2020-06-19T01:49:32Z

Samer:

Regenerating Tanker is a custom character concept by [[User:Samer|Samer]].

The idea is he's a tanker with the ability of health regeneration like [[Barabas]]. 
He's the pro wrestler, Syndicate commander on whom the Tanker SLDs were later based on. 
Along with [[Kojiro]] and [[Grey Fury]] they make up the [[Saisei Team]].
 
 
The mod can be found [http://oni.bungie.org/community/forum/viewtopic.php?id=2046 here]

[[File:Regenerating Tanker.jpeg|800px]]

[[Category: Tankers]][[Category:Modding projects]]

File:Regenerating Tanker.jpg

2020-06-19T01:46:17Z

Samer: Category:Modding screenshots

== Summary ==
[[Category:Modding screenshots]]

Regenerating Tanker

2020-06-19T01:39:19Z

Samer:

Regenerating Tanker is a custom character concept by [[User:Samer|Samer]]. The idea is he's a tanker with the ability of health regeneration like [[Barabas]].
He's the latest in the chrysalis experimentation by the Syndicate, a strange mix of SLD technology and chrysalis.
Along with [[Kojiro]] and [[Grey Fury]] they make up the [[Saisei Team]].

The mod can be found [http://oni.bungie.org/community/forum/viewtopic.php?id=2046 here]

https://lh4.googleusercontent.com/-xL-JyKO7UMM/TkgpyUUqtII/AAAAAAAAB3A/ZyXnc3lmbvk/s800/Captures34.jpg

[[Category: Tankers]][[Category:Modding projects]]

Kojiro

2020-06-19T01:34:31Z

Samer:

Kojiro is a communications trooper, and a prominent minion of Muro; unnamed in the story, the fans have supplied their own name for him.

==Appearances in Game==
*At the end of {{C|3}}, he offers to kill Konoko as Muro's van drives away.
*At the end of {{C|5}} in the airplane besides Muro, where it is revealed that he has been monitoring Konoko, unveiling the existence of Shinatama.
*In {{C|6}} he is seen taking part in the raid on TCTF HQ himself, giving the order to "converge" to "all units" involved.
* In {{C|7}}, standing by Muro as Shinatama is being tortured
* In {{C|8}}, following Muro on his way out of the ACC.

==Playable Character==
He was made into a custom playable character by [[User:Samer|Samer]] and also made part of the [[Saisei Team]]. Mod available [http://oni.bungie.org/community/forum/viewtopic.php?id=1282 here]

https://lh6.googleusercontent.com/-zMDEqynvciY/UDt3WKgmjCI/AAAAAAAACag/RCLtMNTupHE/s800/2012-08-27_071037.jpg

[[Category:Characters]][[Category:Comm Troopers]][[Category:Modding projects]]

Casey

2020-06-19T01:26:00Z

Samer:

[[Casey]] is the name given by the fandom to the enigmatic red-haired man who appears in the [[:Image:Intro_frame_0562.png|intro movie]], and on the fail screens of [[:Image:Act_1_.MISSION_FAILED.png|Act 1]] and [[:Image:Act_2_.MISSION_FAILED.png|Act 2]].
*[[Hardy LeBel]] [http://carnage.bungie.org/oniforum/oni.forum.pl?read=19649 stated] on the {{OCF}} that he might have been a love interest of [[Konoko]]'s in the storyline 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]] (a.k.a. andrashi), [[User:geyser|geyser]] came up with the family name "Shanahan". The idea was that he is of Irish descent. (Unlike Griffin)

;Playable character
*Casey was made into a playable character by [[User:Samer|Samer]], and was given custom moves and various outfits. The mod can be discussed [http://oni.bungie.org/community/forum/viewtopic.php?id=1262 here]
https://lh6.googleusercontent.com/-wtSeg28uXA8/UDIFDTq2DgI/AAAAAAAACUQ/yrexZTjNME4/s800/2012-08-20_122305.jpg
*Prior developments of this character are due to Loser (a.k.a. andrashi) and geyser. They weren't as sophisticated as Samer's mod. [http://geyser.oni2.net/pics/screenshots/KONOKOandRED.jpg HERE] is an early screenshot.

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

BGI characters

2020-06-19T01:25:21Z

Samer:

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 [http://wiki.oni2.net/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.
https://lh5.googleusercontent.com/-uUMIztpp5dc/UHi1DxohfAI/AAAAAAAADCE/_5FeN7iCuOw/s400/Oni%25202012-10-13%252003-23-54-54_cr.jpg
https://lh3.googleusercontent.com/-cIvz49ukHUo/UHi1J-HnhnI/AAAAAAAADCM/msJwdCrWqi4/s400/2012-10-13_032154.jpg

==[[Sarai]]==
*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/community/forum/viewtopic.php?pid=46869#p46869 here].
https://lh4.googleusercontent.com/-VdlCgdrk9SQ/UdETSEN-_7I/AAAAAAAAEIw/L1SvBM5S_uk/s640/2013-07-01_081718.jpg

==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.
*The characters' design is inspired/influenced by The Matrix's Agents.
*Mod available [http://oni.bungie.org/community/forum/viewtopic.php?id=1329 here].
https://lh3.googleusercontent.com/-j_xPDwBVpAE/UVvlObgWLRI/AAAAAAAAEI8/sy_hN-778t0/s400/2013-04-03_111405.jpg https://lh3.googleusercontent.com/-oQnOpUZKrJ4/UVvlS4BwQXI/AAAAAAAAEJA/2trmbSqcR0M/s400/2013-04-03_111414.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/community/forum/viewtopic.php?pid=19624#p19624 here].
*:(A major influence of the concept was [[wp:Rhino_(character)|Marvel's Rhino]] (c.f. [https://www.renderhub.com/rip-van-winkle/rhino-from-marvel-strike-force])
*The model and textures are made by [[User:Ltemplar|Ltemplar]].
*Mod available [http://oni.bungie.org/community/forum/viewtopic.php?id=2490 here].
https://lh3.googleusercontent.com/-NKwyBIr3d4U/ULjzrFQiPbI/AAAAAAAAEJI/JdfsQI-tNb4/s640/2012-11-30_194302.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/community/forum/viewtopic.php?pid=19624#p19624 here].
*The design of the character took inspiration from [[Hikari]].
*Mod discussion [http://oni.bungie.org/forum/viewtopic.php?id=2936 here].
https://lh3.googleusercontent.com/pw/ACtC-3fr5cf4yv9cRhTuwmmefIYKCyenpH8FSGXigu66Thgju3IZNXv6Ndy9qohAVm69ZdtC3nXsfZXjEg_Gw4hTXKbptTxI1tIKqJC6k_uXq01lApIAbziMIkrbtfI0PpAtxM2VFM436xNqVEdDeXYjS5_u=w1000-no-tmp.jpg

==BGI NinjaBot==
*A light and quick BGI Bot.
*Model imported by Samer, original model found <strike>[http://thefree3dmodels.com/stuff/characters/robot_warrior/14-1-0-1497 here]</strike>. [https://downloadfree3d.com/3d-models/weapons/robot/robot-warrior/ LINK1] [https://www.domawe.net/2014/09/robot-knight-3d-model-free-download-rf.html LINK2]
*:(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://oni.bungie.org/community/forum/viewtopic.php?id=2438 here].
https://lh5.googleusercontent.com/-znHgHqvu4cw/UGyEyDjIqrI/AAAAAAAAEJU/m0sj_Di8ZUw/s640/2012-10-03_213104.jpg

==BGI Heavy Bot==
*The general idea of a "BGI heavy" is by geyser, discussed [http://wiki.oni2.net/AE:BGI#Candidate here].
*Model imported by geyser (from an unsourced SketchUp model)
*:(Years later, it was identified as [https://www.models-resource.com/pc_computer/unrealtournament2004/model/3923/ 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://oni.bungie.org/community/forum/viewtopic.php?id=2445 here].
https://lh6.googleusercontent.com/-ViJlYvPRQ6o/UHHQo6WVS_I/AAAAAAAAEJY/QpPP4UlBAts/s640/2012-10-07_185344.jpg

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

Sarai

2020-06-19T01:23:41Z

Samer:

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/community/forum/viewtopic.php?pid=46869#p46869 here]

==Concept==
Sarai, the female BGI boss. 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.

==Model==
The model is based on DarkLitria's sketch seen [[:Image:Sarai.png|here]]. The head mesh is from a [http://oni.bungie.org/community/forum/viewtopic.php?pid=16272#p16272 project] started by Lapis which was later abandoned, with further modeling and texturing done by Samer.

https://lh4.googleusercontent.com/-VdlCgdrk9SQ/UdETSEN-_7I/AAAAAAAAEIw/L1SvBM5S_uk/s800/2013-07-01_081718.jpg

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

Saisei Team

2020-06-19T01:21:50Z

Samer:

The Saisei Team is a concept by [[User:Samer|Samer]] inspired by [[User:Paradox-01|Paradox-01]]'s all grey health regenerating Syndicate team.
Saisei is Japanese for regeneration/ regrowth / rebirth.
Currently, the Saisei Team is composed of : [[Grey Fury]], [[Kojiro]] and [[Regenerating Tanker]].

https://lh5.googleusercontent.com/-5JZTL4aBL08/Txp5fArK8uI/AAAAAAAAB74/LAiaVFlZ7rU/s800/Oni%2525202012-01-21%25252010-27-09-28_cr.jpg

Besides the ability to regenerate health, these characters share a common Emblem designed by Samer.
https://i.imgur.com/munanT7.png

The emblem represents a person with arms wide open, similar to the pose these characters take when they health regenerate.
It also represents ascension, the bottom half of the emblem resembles spikes or mutations due to chrysalis. The overall shape also resembles an insect somehow with wings, as reference to the Imago stage of the chrysalis which also used for the last stage of metamorphosis of an insect.

Other appearances for the Emblem during its creation https://i.imgur.com/CrheUtU.png

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

Saisei Team

2020-06-19T01:15:50Z

Samer: Samer moved page Skull Team to Saisei Team

The Saisei Team is a concept by [[User:Samer|Samer]] inspired by [[User:Paradox-01|Paradox-01]]'s all grey health regenerating Syndicate team.
Saisei is Japanese for regeneration/ regrowth / rebirth.
Currently, the Saisei Team is composed of : [[Grey Fury]], [[Kojiro]] and [[Regenerating Tanker]].

https://lh5.googleusercontent.com/-5JZTL4aBL08/Txp5fArK8uI/AAAAAAAAB74/LAiaVFlZ7rU/s800/Oni%2525202012-01-21%25252010-27-09-28_cr.jpg

Besides the ability to regenerate health, these characters share a common Emblem designed by Samer.
https://i.imgur.com/munanT7.png

The emblem represents a person with arms wide open, similar to the pose these characters take when they health regenerate.
It also represents ascension, the bottom half of the emblem resembles spikes or mutations due to chrysalis. The overall shape also resembles an insect somehow with wings, as reference to the Imago stage of the chrysalis which also used for the last stage of metamorphosis of an insect.

Other appearances for the Emblem during its creation https://i.imgur.com/CrheUtU.png

[[Category:Syndicate]]

Saisei Team

2020-06-19T01:13:19Z

Samer:

The Saisei Team is a concept by [[User:Samer|Samer]] inspired by [[User:Paradox-01|Paradox-01]]'s all grey health regenerating Syndicate team.
Saisei is Japanese for regeneration/ regrowth / rebirth.
Currently, the Saisei Team is composed of : [[Grey Fury]], [[Kojiro]] and [[Regenerating Tanker]].

https://lh5.googleusercontent.com/-5JZTL4aBL08/Txp5fArK8uI/AAAAAAAAB74/LAiaVFlZ7rU/s800/Oni%2525202012-01-21%25252010-27-09-28_cr.jpg

Besides the ability to regenerate health, these characters share a common Emblem designed by Samer.
https://i.imgur.com/munanT7.png

The emblem represents a person with arms wide open, similar to the pose these characters take when they health regenerate.
It also represents ascension, the bottom half of the emblem resembles spikes or mutations due to chrysalis. The overall shape also resembles an insect somehow with wings, as reference to the Imago stage of the chrysalis which also used for the last stage of metamorphosis of an insect.

Other appearances for the Emblem during its creation https://i.imgur.com/CrheUtU.png

[[Category:Syndicate]]

Videos

2020-06-15T16:32:14Z

Samer:

Videos

2020-06-15T14:50:46Z

Samer:

Videos

2020-06-15T14:37:28Z

Samer: removed paradox dead links, added some of delano's and s10k videos.

BGI characters

2020-06-10T23:11:26Z

Samer:

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 [http://wiki.oni2.net/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.
https://lh5.googleusercontent.com/-uUMIztpp5dc/UHi1DxohfAI/AAAAAAAADCE/_5FeN7iCuOw/s400/Oni%25202012-10-13%252003-23-54-54_cr.jpg
https://lh3.googleusercontent.com/-cIvz49ukHUo/UHi1J-HnhnI/AAAAAAAADCM/msJwdCrWqi4/s400/2012-10-13_032154.jpg

==[[Sarai]]==
*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/community/forum/viewtopic.php?pid=46869#p46869 here].
https://lh4.googleusercontent.com/-VdlCgdrk9SQ/UdETSEN-_7I/AAAAAAAAEIw/L1SvBM5S_uk/s640/2013-07-01_081718.jpg

==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.
*The characters' design is inspired/influenced by The Matrix's Agents.
*Mod available [http://oni.bungie.org/community/forum/viewtopic.php?id=1329 here].
https://lh3.googleusercontent.com/-j_xPDwBVpAE/UVvlObgWLRI/AAAAAAAAEI8/sy_hN-778t0/s400/2013-04-03_111405.jpg https://lh3.googleusercontent.com/-oQnOpUZKrJ4/UVvlS4BwQXI/AAAAAAAAEJA/2trmbSqcR0M/s400/2013-04-03_111414.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/community/forum/viewtopic.php?pid=19624#p19624 here].
*:(A major influence of the concept was [[wp:Rhino_(character)|Marvel's Rhino]] (c.f. [https://www.renderhub.com/rip-van-winkle/rhino-from-marvel-strike-force])
*The model and textures are made by [[User:Ltemplar|Ltemplar]].
*Mod available [http://oni.bungie.org/community/forum/viewtopic.php?id=2490 here].
https://lh3.googleusercontent.com/-NKwyBIr3d4U/ULjzrFQiPbI/AAAAAAAAEJI/JdfsQI-tNb4/s640/2012-11-30_194302.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/community/forum/viewtopic.php?pid=19624#p19624 here].
*The design of the character took inspiration from [[Hikari]].
*Mod discussion [http://oni.bungie.org/forum/viewtopic.php?id=2936 here].
https://lh3.googleusercontent.com/pw/ACtC-3fr5cf4yv9cRhTuwmmefIYKCyenpH8FSGXigu66Thgju3IZNXv6Ndy9qohAVm69ZdtC3nXsfZXjEg_Gw4hTXKbptTxI1tIKqJC6k_uXq01lApIAbziMIkrbtfI0PpAtxM2VFM436xNqVEdDeXYjS5_u=w1000-no-tmp.jpg

==BGI NinjaBot==
*A light and quick BGI Bot.
*Model imported by Samer, original model found <strike>[http://thefree3dmodels.com/stuff/characters/robot_warrior/14-1-0-1497 here]</strike>. [https://downloadfree3d.com/3d-models/weapons/robot/robot-warrior/ LINK1] [https://www.domawe.net/2014/09/robot-knight-3d-model-free-download-rf.html LINK2]
*:(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://oni.bungie.org/community/forum/viewtopic.php?id=2438 here].
https://lh5.googleusercontent.com/-znHgHqvu4cw/UGyEyDjIqrI/AAAAAAAAEJU/m0sj_Di8ZUw/s640/2012-10-03_213104.jpg

==BGI Heavy Bot==
*The general idea of a "BGI heavy" is by geyser, discussed [http://wiki.oni2.net/AE:BGI#Candidate here].
*Model imported by geyser (from an unsourced SketchUp model)
*:(Years later, it was identified as [https://www.models-resource.com/pc_computer/unrealtournament2004/model/3923/ 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://oni.bungie.org/community/forum/viewtopic.php?id=2445 here].
https://lh6.googleusercontent.com/-ViJlYvPRQ6o/UHHQo6WVS_I/AAAAAAAAEJY/QpPP4UlBAts/s640/2012-10-07_185344.jpg

[[Category:BGI]]