Developer Mode: Difference between revisions
| Line 212: | Line 212: | ||
| | | | ||
|Secret X / Toggle show trigger volumes | |Secret X / Toggle show trigger volumes | ||
| | |<center>{{ckblue}}</center> | ||
|<center>{{ckblue}}</center> | |<center>{{ckblue}}</center> | ||
|- | |- | ||
Revision as of 01:22, 18 March 2014
Syndicate Warehouse
Developer Mode is a bundle of features created by Bungie West to help them develop Oni: a console line for entering scripting commands, manual camera controls, and various debugging features. It is enabled by the cheat code thedayismine (see "Download it..." below before trying the code).
Despite being hinted at by a crate texture (right) and leaked as part of a list of cheat codes during beta testing, this cheat code did not work upon Oni's release, and it was long believed that Developer Mode had been cut from retail versions of Oni. However, Dev Mode is actually present in all available versions of Oni (except PS2). It just needed to be unlocked, as the community learned back in 2006.
Below you will find download links, unlocking instructions, and finally an overview of the Developer Mode's features.
Getting it to work
Download it...
In Windows, you can install the Daodan DLL to unlock Developer Mode; note that the Anniversary Edition installs the Daodan DLL automatically.
On the Mac, the Intel build of Oni already has Dev Mode unlocked; note that the Anniversary Edition installs the Intel build automatically.
Using it
First check
Cheats are normally unavailable until you finish the full version of the game, and Developer Mode can only be activated through a cheat code. For unlocking cheats "manually" (especially necessary with the demos), see HERE. However, cheats are enabled all the time when the Daodan DLL is installed in Windows or when using the Mac Intel build.
Enter the Pause screen (default key F1) and look for a confirmation message after typing the Developer Mode cheat (thedayismine, or killmequick if you followed the DIY tutorial, or just x -- the DLL and Intel build provide that shortcut). However, you may not notice anything special when you get back to the game (although there should be occasional console messages appearing at the bottom-left).
The quickest way to tell whether Dev Mode definitely works, right after you get the confirmation message, is to exit the Diary screen and to press End. That should teleport you to where the camera is (usually back and up, possibly through walls and ceilings).
Here's another quick test, meant to see if the Control and Alt keys work fine (on Mac, use the Option key instead of Alt): Ctrl+Shift+U and Ctrl+Alt+U should both perform the "unstick" action; Konoko will shift forward by a small amount.
Console output
In Developer Mode, Oni prints debug messages about in-game events along the bottom-left of the screen. Past messages scroll up across the screen and fade. In some situations, messages don't fade (e.g. if character debugging is enabled or you are currently using the console line).
The easiest way to check whether that output works at all is to press F8: the character class change is acknowledged with a console message.
If you don't see anything, that means console output is unfortunately disabled in your version of Oni. If you're on PC retail, you may have applied Ian's patch (aka XP patch), which disables console output. On PC demo, both console output and console input are invisible (i.e. you can enter script commands, but you're "blindfolded").
Console input
U.S. QWERTY: By default, Oni auto-binds the "console" toggle to the key which on U.S. keyboards has a grave accent, `, in the lowercase position and a tilde, ~, in the uppercase position. It is usually called the "tilde key" by users, and perhaps even elsewhere on this wiki; however, you would have to hold Shift to type a tilde, and the console is activated by just pressing the key without Shift, thus it is actually the "grave accent key" which activates the console. On non-U.S. keyboards, that key may not be recognized. Just add a line like "bind leftalt to console" to key_config.txt in your Oni folder and you'll be able to open the console with that key. In some cases, this bound key will not close the console; however, pressing the grave accent key, oddly enough, may work.
German QWERTZ: By default, Oni uses the circumflex accent key, ^, for console access. On Windows, when playing Oni in windowed mode, you should use "rightalt" as your alternative console binding because "leftalt" activates the window's menu, stealing Oni's controls.
Features
Many of the features listed below no longer work as intended, or work at all, either due to changes to the code made at the end of development or the absence in retail Oni of resources that the features were intended to call upon, such as level0_Tools. Nevertheless, some of these features are helpful for modders, most notably the camera controls and dev console.
Hotkeys
Below are Oni's hardcoded mappings for Developer Mode functions. The Alt key (Option key on Macs) can be used in placed of Ctrl. Alternate mappings are welcome if you have another version of Oni that you would like to have listed below.
The QWERTY column is for the English release of Oni, for U.S. QWERTY keyboards. The QWERTZ column is for German Oni and only lists the hotkeys that are different from QWERTY on German QWERTZ keyboards; note that on German keyboards, the "Ctrl" key is named "Strg".
| Hotkey (QWERTY) | Hotkey (QWERTZ) | Description | Windows | Mac |
|---|---|---|---|---|
| Ctrl+Shift+o | Draw no-occlusion quads (only makes console screens disappear) | |||
| Ctrl+Shift+i | Draw invisible quads | |||
| Ctrl+Shift+y | Ctrl+Shift+z | Performance display (includes FPS) |  |
|
| Ctrl+Shift+t | Draw character collision | |||
| Ctrl+Shift+r | Draw object collision | |||
| Ctrl+Shift+f | Fast Mode (runs Oni at up to 24x) | |
| |
| Ctrl+Shift+g | Draw Every Frame Mode | |
||
| Ctrl+Shift+x | Secret X / Toggle show trigger volumes | |
| |
| Ctrl+Shift+y | Secret Y | |||
| Ctrl+Shift+z | Secret Z | |||
| Ctrl+Shift+Ins | Add flag | |
||
| Ctrl+Shift+Del | Delete flag | |
| |
| Ctrl+Shift+u | Unstick player | |
| |
| Ctrl+Shift+n | Camera recording start | |||
| Ctrl+Shift+m | Camera recording stop | |||
| Ctrl+Shift+, | Camera recording playback | |||
| ? | Place quad | |||
| ? | Place quad mode | |||
| Ctrl+Shift+\ | Ctrl+Shift+# | Profile toggle (doesn't seem to have any effect) | |
|
| Ctrl+Shift+l | Dumps a screenshot every frame | |
| |
| Ctrl+Shift+1 | Test One | |||
| Ctrl+Shift+2 | Test Two | |||
| Ctrl+Shift+3 | Test Three | |||
| Ctrl+Shift+4 | Test Four | |||
| . (period) | Single Step Mode | |
| |
| / | - | Advance one step (when in Single Step Mode) | |
|
| .+/ | .+- | Exit Single Step Mode (press keys simultaneously) | |
|
| Ctrl+Shift+Home | Cycle active camera | | ||
| End | Warp to camera | |
| |
| Ctrl+Shift+k | Kill particles | |||
| Backspace | Enter AI debugger | |||
| 7 | Explode One | |||
| 8 | Explode Two | |||
| 9 | Explode Three | |||
| 0 | Explode Four | |||
| Ctrl+Shift+j | Reset particles | |||
| Ctrl+Shift+w | Drop flag and add waypoint | |||
| Ctrl+Shift+b | Shows current opponent's logic | |
| |
| ] | ~ | Freeze (now causes camera drift while on; stopping Freeze mode teleports to camera location) |
|
|
| [ | Frame Advance (now renders Konoko at camera location) | |
| |
| Ctrl+Shift+s | Highlight furniture (turns their textures red) | |
||
| F8, Shift+F8 | Cycle characters | |
| |
| Ctrl+Shift+p | Display particle performance | |||
| Ctrl+Shift+; | Lock particle performance display | |||
| F2 | Cutscene Animation 1 | |
| |
| F3 | Cutscene Animation 2 | |
| |
| F6 | Kill all AIs | |
| |
| Ctrl+F7 | Play dead | |
| |
| F7, Shift+F7 | Cycle weapons (holster to get second weapon) | |
| |
| F9 | Start recording | |
| |
| F10 | Stop recording | |
| |
| F11 | Playback recording | |
| |
| ` (grave accent) | ^ | Displays console | |
|
| Return/Enter | Cycle camera modes (see table below for camera controls): 1. Normal 2. Detached A - mouse still controls character aim 3. Detached B - mouse aims camera |
|
|
(1) On Macs, Draw Every Frame Mode speeds up the game almost to the extent of Fast Mode, but with glitchy animations.
(2) Please see talk page section "Insert key on Macs".
Camera controls
Note that the camera controls have default mappings, given below, but unlike the developer hotkeys, they are custom-bindable. In fact, on Macs, the default numpad bindings need to be customized or they won't work at all. See note HERE about how to bind these keys and fix the Mac numpad controls. Also, the definitions of panning left and right seem to be reversed, as NumPad4 will simulate the act of turning your head to the left, but its action is called "man_cam_pan_right", and vice versa for NumPad6....
Windows
|
Mac
|
Runtime scripting
Basic idea
(Almost) anything you write in scripts you can enter at runtime with the console. The only thing you can't do is register new variables and functions.
You can call existing functions, check on the values of existing variables. "Existing" means either built-in ones, or part of the original level logic, or part of your own scripts for the given level.
If a function/variable was succesfully registered by Oni during level load, you will be able to refer to them from the console.
You will even be able to browse the registered variables/functions with the Tab key, while typing at the console. Tab autocompletes the command being typed, then cycles through all available commands in (hex)alphabetical order (A...Z come before a...z). Shift+Tab lets you go back.
Previous commands can be navigated with up and down arrows. You can't insert/delete text in the middle of a command : you have to use Backspace.
The only keys that have an effect while the console is active are : Escape, Enter, Backspace, (Shift+)Tab, ASCII character keys and the arrow keys.
If you press an illegal key during console input (such as F1), the input display will freeze : hit Tab a few times to fix.
Limitations
Obviously, if you have no console output, it's a bit frustrating. Even more so if console input is invisible -- you're in for some blindfolded scripting then. Still, there are a few commands which you can type in as complements to regular cheats:
- chr_nocollision 0 1 and chr_nocollision 0 0 enable/disable no-clipping. When in no-clipping mode, you can't fall down; thus, jumping makes you flail in midair, and eventually you die (so be careful about that)
- give_powerup shield gives you a force shield (which you can't have with fatloot)
- dump_docs prints all the registered commands/variables to a file in your Oni folder (so you know just what you can type)