1,288 Pages

Mods for NReality take the form of a string added to the end of the standard map data. When the map is loaded, the string disappears and the modifications are applied. The string is formatted like this:


Player 03 has created a basic list of mods for NReality which can be used when looking for simple mods instead of scrolling through all this.

Background Image

This function allows a URL image to be inserted into the map. A Background Image will be displayed in the background and will be covered by tiles and objects.

Foreground Image

This function also allows a URL image to be inserted into the map. A Foreground Image will be displayed in front of everything else in the map, meaning if you want to see anything, you will need to use a program that can create transparency (e.g: GIMP, Photoshop etc). This excludes paint, so if that's all you have, then you cannot create transparency.

The foreground image can also be made into a color filter, as described here. To do this, add ?# to the end of the image URL, where # is a number between 1 and 14.


Any text in this slot will appear as a map's category when the map is displayed in the userlevels menu.


This slot allows modifications to any type of object, though modifications to the ninja should be done in the playerMod slot. Modifications are applied to every object of the selected type, not to individual objects.

The modifications are formatted like this: objectNumber,property,modification;, and any number of them can be strung together.
objectNumber indicates the type of object and currently must be some of the numbers between 0 and 141 depending on the object's number.
property indicates the property of the object to be modified.
modification indicates the new value of the property, and it must be a number.

Some of the modifications in here don't acctually go after the fourth "|", some of them need to be manually typed into the object data area as an object (e.g: 6^x,y,Path,0,122,direction, for a tile drone). This allows modifications to be applied to any single object.

The objects indicated by each number are these:
0: zap drone, seeker drone
1: laser drone, rotating laser drone
2: chaingun drone
3: gold
4: bounceblock
5: launchpad
6: gauss turret
7: surface guards
8: ninja
9: drone (note: does not appear to affect any drones; use 0, 1, and 2 instead)
10: oneway platform
11: thwump
12: door
13: rocket launcher
14: exit
15: mine
16: force field drone
101, 102, 103: ghost drone
121: rocky drone
122: tile drone
132: alarm drone
141: greedy drone

Glitched drones (a.k.a. "eye drones") cannot be modified because the game does not recognize them as any of the three modifiable types of drones.

All objects have some additional properties that can be applied to them. As these are the same for all objects, they are only listed once, in their own section.

Note: no matter how big you make an object, it cannot interact with the ninja unless he is in the same grid square or an adjacent one.

About Special drones

Other types of drones can be created by modifying a part of the standard code for a drone (6^x,y,path,specialType,droneType,direction). x and y control the drone's coordinates, path controls the drone's pathfinding algorithm, specialType indicates whether or not the drone is the standard drone of its type (e.g., whether it is a seeker drone rather than a regular drone), droneType controls the type of drone, and direction controls the drone's direction.

Here are the parameters that can be set for each type of object:
(Note: not all parameters have an effect on gameplay.)

Zap Drone & Seeker Drone (0)

default = 9
default = 1
chaseSpeed default unknown Note: the game treats 0 as the default value. If you want a drone to stop when it sees the ninja, use a very low value (like 1e-9) instead.

Also, speed and chaseSpeed can be modified per drone, by use of ^speed,chaseSpeed after the drone's code.

Laser Drone & Rotating Laser Drone (1)

default = 9
default= ???
default = 30; determines the amount of time the drone will spend charging
default = 40; determines how long the drone will pause after firing
default = 80; determines how long the drone will fire
default = 7; usage unknown

To create a rotating laser drone, replace the fourth attribute of a normal laser drone (specialType) with 1. The code for a rotating laser drone should look like 6^x,y,path,1,1,direction.

Modifications for the rotating laser drone:
default = 0; controls the angle at which it starts
default = 0.5; controls the speed and direction of rotation
no default value; if set, the laser will always be a fixed number of pixels long and can go through walls
default = 0; if set to anything else, the laser drone will move as it fires and rotates.

Also, adding ^1,2,3,4,5 to the end of the code for a rotating laser drone will set the starting angle (1), rotation speed (2), the laser length (3), whether or not the laser moves (4), and its speed (5). This will override global modifications of these same attributes.

Chaingun Drone (2)

default = 9
default = 35; determines the amount of time the drone will spend charging
default = 60; determines how long the drone will pause after firing
default = 8; usage unknown
default = 6; determines the time, in frames, between each bullet
default = 0.3; usage unknown

Gold (3)

default = 6

Bounceblock (4)

default = 0.05; controls the speed at which the block bounces back- very high or very low values may prevent it from doing so
default = 0.2; controls the amount of force the block applies against the ninja- negative values make it propel the ninja forward
default = 40; determines how close the block has to come to its start position before it stops moving- low values make it stop sooner
default = 0; usage unknown

Launchpad (5)

default = 6
default = 5.1428568; controls launchpad strength

Gauss Turret (6)

default = 0.05; determines how fast the crosshairs move when close to the ninja, represents the percentage of the distance between them covered
default = 0.035; determines how fast the crosshairs move when a medium distance away from the ninja
default = 0.03; determines how fast the crosshairs move when far away from the ninja
default = 0.03; determines how fast the crosshairs move the frame after the turret fires
default = 9216; determines how far away from the ninja is considered "far" away
default = 1764; determines what is considered to be "mid" distance from the ninja
default = 576; determines how close the crosshairs must be to the ninja to be considered "close"
default = 60; controls the minimum time between shots
default = 0; usage unknown
default = 0; usage unknown
default = 10; controls the turret's warm-up time
default = 10; controls the turret's cooldown time

Surface Guards (7)

default = 6
default = 5.1428568

Ceiling guards are created by adding ^1 to the code of a floorguard (4^x,y). Its speed can be changed by adding ^1,speed instead. A wall guard is created by adding either ^2(left) or ^3(right) instead.

In short:

Floor Guard : 4^x,y,1^0
Ceiling Guard : 4^x,y,1^1
Left Wall Guard : 4^x,y,1^2
Right Wall Guard : 4^x,y,1^3

...although adding ^0 for the normal floorguard is completely unnecessary.

Values over about 30 for guards will only continue to increase the guards' aesthetic size; the size of their collision detection zone caps at about 30.

Important note: Increasing guards' size can have adverse effects on their placement; when one attempts to load the code, it changes the guard's location on the Y axis to compensate for the size (so that the bottom of the guard will still touch the bottom). When going into the editor, it reverts changes, but keeps the coordinates intact, which leads to newly located guards, moved upwards. Adding the code again and loading will again compensate, moving the guard even further up. Furthermore, attempting to move the guard manually in the editor, while helping, still does not completely eradicate the changes; when exiting out of the editor, the guards will be moved back up, though to a lesser amount.

Added also is an always chase function.


alwaysChase: default 0, set it to 1 if you want it able to always chase the ninja

Ninja (8)

See Player Mod section.

Drones (9)

No known properties.

Oneway Platform (10)

You can use special triggers to make oneway platforms appear and disappear.

oneway special off : make the one way disappear

oneway special on:
case 1: if the one way has disappeared, it will reappear
case 2: if the one way is not disappeared, then it will rotate 90 degree

See more on special triggers here.

Thwump (11)

(some apparently useless settings omitted)
default = 9; controls thwump's width
default = 9; controls thwump's height
default = 4.2857148; controls thwump's forward speed
default = 1.7142852; controls thwump's backward speed
duplicate of fallspeed

A note about variables xw and yw:

The further you increase the proportions, the more "bouncy" it becomes. This is hardly noticeable at all for smaller values over the default of 9, but for higher values it becomes increasingly easy to trigger the "bounciness" (which seems to be easier to trigger the faster you come at it, and is always easier on the sides). Any values over about 26 pixels for either dimension (though the x dimension is *slightly* more sensitive to this) will cause it to be reliably "bouncy," making it so it is impossible to stay touching it for more than a frame or two at a time. The collision detection seems to cap at about 30 pixels wide/tall, but the magnitude of the "bounciness" continues to increase with no known limit, eventually killing the ninja the moment he hits the collision box, which is nested deep inside the sprite. Furthermore, while the blue "zap" part at the end continues to zap correctly upon impact (up to about 30), the thwump's collision with tiles does not seem to scale at all. It will "hit" the tile about a normal thwump's length away from the end of it, meaning the blue "zap" part can easily clip through many tiles, along with the rest of it.

Door (12)

default = 10; apparently useless
default = ~10; apparently useless
default = 5; controls how long the normal doors stay open after the ninja passes through

Rocket Launcher (13)

default = 0; usage unknown
default = 3.4285716; controls the rocket's maximum speed
default = 0.1; controls the rocket's acceleration for the first frame after it is created
duplicate of startaccel
default = 1.1; controls the rocket's acceleration
default = 0.1; controls how far the rocket turns in one frame- at high values, it tends to turn too far and actually becomes less accurate
default = false; usage unknown
default = 10; controls how long the turret waits before firing a rocket, but has no effect on lagtime
default = 0; usage unknown

Exit (14)

default = 12; does not affect the exit switch.

~27 appears to be the functional limit. The door will still aesthetically grow, but will functionally be only about 27 pixels wide.

Mine (15)

default = ~4

~40 appears to be the functional limit. The mines will still aesthetically grow, but they functionally only be about 40 pixels wide.

Force Field Drone (16)

This drone repels or attracts the ninja towards or away from it when it reaches a certain range.


These can be added at the end of the code in the ObjectMod section or on to any individual drone.

default = 100; controls the distance at which the drone starts firing
default = 4; controls the force at which the ninja is pushed away from the drone (note: the ninja's velocity is reset when the drone fires, like when he hits a launchpad)
default = 10; controls the length of the drone's cooldown time (the drone keeps moving during this time, unlike other drones)
default = 3; controls the number of consecutive shots the drone can fire before recharging for a longer time
default = 200; controls the time spent recharging after forceMaxCount is reached
default = 0; controls whether or not the force field drone will stop when it activates it force field; 0 for stopping, 1 for continuing.

These properties, as well as the additional properties for all objects, can be modified in the standard way:
default = 1;
default = 9;

Ghost Drone (101, 102, or 103)

Ghost drones follow the ninja whenever he isn't looking and stop when he is. The main difference between the types is that the second type does not hurt the ninja when stopped, and the third type acts like a rocky drone when stopped.


These can be added at the end of the code in the ObjectMod section or on to any individual drone.

default = 0.02; controls how fast the drone accelerates towards the ninja
default = 2; controls how fast the drone can go
default = undefined; if set to 1, the first type of drone will not stop moving
default = 0; controls how completely the second type can fade away

Rocky Drone (121)

This drone is essentially a platform that moves like a drone.


Change number in bold to 1 to make the drone seeking.

These properties, as well as the additional properties for all objects, can be modified in the standard way:
default = 1;
default = 9;

Tile Drone (122)

This drone will place tiles behind it as it travels.


Change number in bold to 1 to make the drone seeking.

Tiles is the text string for the tile pattern, it is just like the map data, the tile drone will loop through the string to lay the tiles. For example, if you use "NN10", the drone will place two 5-tiles, an E-tile, a space, and then repeat.

Alarm Drone (132)

This drone will emit a circular laser going outwards when it sees the ninja. The ninja will die upon contact with the laser.


Change number in bold to 1 to make the drone seeking.

laserMinRadius, the min radius of the laser, default 30
laserMaxRadius, the max radius of the laser, default 400
radiusUp, the increase rate of the radius, default 1
radiusDown, the decrease rate of the radius, default 2
neverDown, if it is set to 1 then the laser will never decrease in size
alwaysMove, if it is set to 1 then the drone will move even when it sees you

Greedy Drone (141)

This drone can steal or give time/gold to the ninja.


Change number in bold to 1 to make the drone seeking

For collect_coin: value for stealing 1 second = -40 value for stealing 1 frame = -1 value for giving player 1 second = 40 This value must be an integer.

AI Pathing Objects

All objects except rocket launcher and floor guard can be applied for Drone's AI Pathing system on it.

AI Pathing Objects : append ^^^customPath,PathID,Direction,speed

Path ID:
SURFACE FOLLOW Clock Wise = 0;
SURFACE FOLLOW Counter Clock Wise = 1;
WANDER Clock Wise= 2;
WANDER Counter Clock Wise = 3;
Nreality CustomPath = 6;
Circular Movement = 7;
Coordinates Pathing = 8;
Chase AI = 9;
Chasing Pathing = 10;

Circular Pathing

Path ID 7: append the following to the drones/objects:

This will use objects' original position as center; x,y

Chase Pathing

Path ID 10: append the following to the drones/objects:

chaseWhenSighted: makes the object/drone chase the ninja only when the it sees the them.
chaseKeepUpdate: makes the drone/object keep updating the path when it sees the ninja

Coordinate Pathing

Path ID 8: append the following to the drones/objects:

You can have as many x?.y? positions as you want.
When it moved to the last point it will move back to the first point.

Custom Path

Path ID 6: append the following to drones:
Append the following to objects:

CustomPath is formed with U (up) D (down) L (left) R (right) and every letter represents a tile moved in that direction.

When the end of a custom path is reached, it loops back to the beginning of the custom path to do it all over again. If you need to stop an object from further loops, insert any letter other than U, D, L or R at the end (e.g: B). This will stop the drone moving after the first loop.

For example, using ^^^UR will make the drone zig-zag diagonally upwards. Because there is no stop letter, the drone will not stop, even when it reaches the edge of the map.

Triggerable Objects

Objects can be "triggered" on and off via special door switches. "Off" objects will simply stop moving and not detect the ninja player at all, but they still detect collision, so an "off" zap drone, for example, is still dangerous.

To add "Trigger" to a door switch, append
^startTriggers(if you are using more than one, separate with "."),stopTriggers(separated by ".") to the door switch object (which starts with 9^)

To make the object triggerable, append
^^waitForTrigger,startTriggers(separated by "."),stopTriggers(separated by ".")

waitForTrigger should be set to 1 when you don't want an object or drone moving right away. This is commonly confused with startTriggers.
startTriggers are the trigger(s) which start movement of the drone/object after using waitForTrigger.

Special Triggers

To add "Special Trigger" to a door switch, append
^startTriggersID(separated by "."),stopTriggersID(separated by "."),startSpecialTriggersID(separated by "."),stopSpecialTriggersID(separated by ".") to the door object.

To make the object special triggerable, append
^^waitForTrigger(boolean, 0 or 1),startTriggersID(separated by "."),stopTriggersID(separated by "."),startSpecialTriggersID(separated by "."),stopSpecialTriggersID(separated by ".")

zap drone -> specialOn -> seeker drone
seeker drone -> specialOff -> zap drone

rocky drone -> specialOn -> seeker rocky drone
seeker rocky drone -> specialOff -> rocky drone

greedy drone -> specialOn -> seeker greedy drone
seeker greedy drone -> specialOff -> greedy drone

rotating laser drone:
specialOn-> keep rotating
specialOff->stop rotating

oneway special off : make the one way disappear

oneway special on:
case 1: if the one way has disappeared, it will reappear
case 2: if the one way is not disappeared, then it will rotate 90 degrees

Text Drone

The Text Drone merely serves to add dialogue to the game.


Apart from textArray, all other parameters are optional

textArray: escaped text characters joined by ":"
align: 0=left, 1=center, 2=right
border: 0=no border, 1=has border
textColor & backgroundColor: from 000000 to FFFFFF
font: _sans, _serif, _typewriter, if you put other fonts, other players may not able to see it.
bold, italic, underline : 0 or 1

specialOn Trigger: Display next text in array
SpecialOff Trigger: Hiding the text

escape your text:

If you want to make the drone 'chase' the ninja, use AI Pathing Objects to chase the ninja. You can then ajust the x and y offset to your taste.

Note: Non english characters will not be able to be shown on all users computers.

Custom Icon

To set Custom Icons to objects, use ||||objectType,_icon,x_offset^y_offset^url

Beware that in N, all the object icon sizes are scaled down by default, so the image you loaded will probably be scaled down too. You can set _xscale,100 and _yscale,100 to restore your image's default size. The eye movieclip of the drone will disappear if you change its icon.

Since the image loaded into the object will not auto center itself, you will probably need to set x_offset and y_offset to adjust the correct position of the image to the object.

Additional Properties

There are also some properties relating to an object's display that can be applied to anything. Note that these will not affect gameplay, though.

_xscale controls an object's width. The input is a number of pixels, so setting this to 20 would make the object appear to be 20 pixels wide.
_yscale is the same as _xscale, except it applies to height.
_alpha controls an objects transparency, and can be anything from 0 to 100, with 0 being invisible.
_color controls an object's color, and can modify red, green, and blue values for the object.
It can be set to a value in the format The "%" values multiply that channel by the given percent (e.g., if blue% was 50, the object's blue hues would be half as intense). The "Mod" values add the given amount to that channel.

_color can be used to make an object any color by:

  1. Finding the red, green, and blue values of the target color
  2. Setting _color to 0.redValue.0.greenValue.0.blueValue.100.0

Note: this removes all texture from most objects.


The syntax for this slot is much like the syntax for the objectMod slot, except without the identifier number: property,modification;. Again, any number of these can be strung together.

Here is a list of all modifiable properties:

default = 10
default = 5; controls the maximum speed the ninja can accelerate up to in the air (the ninja can go faster if he is propelled by something else, though)
default = 5; controls the maximum speed the ninja can accelerate up to on the ground
default = 0.15; controls the ninja's acceleration on the ground
default = 0.1; controls the ninja's aerial acceleration
default = 0.15; controls gravity until the first time the ninja jumps
default = 0.99; controls air resistance until the first time the ninja jumps
default = 0.15; controls gravity after the ninja has jumped
default = 0.99; controls air resistance after the ninja has jumped
default = 0.025; controls gravity for a short time after the jump button is pressed for as long as it it held
default = 30; controls the maximum amount of time that jump gravity can apply to the ninja
default = 0.8; controls the speed the ninja experiences after he passes the activated exit door. Increase to make him move faster away from it, or set to "0" to stop moving completely
default = 0.13; controls the friction the ninja experiences while wallsliding
default = 0.92; controls the friction the ninja experiences while sliding to a stop (note: higher values mean less friction, and values above 1 cause the ninja to speed up)
default = 0.8; controls the friction the ninja experiences as he stops sliding entirely
default = 1; controls the strength with which the ninja pushes off from the floor/slopes/walls
default = 2; controls the upwards motion (downwards if negative) the ninja experiences regardless of where he jumps from
default = 9; controls the speed at which hitting the ground becomes deadly
default = 0; set to 1 to disable wall jump
default = 0; set to 1 to disable wall slide
default = 1; set to 2 to enable double jump (i.e. you can jump in air), set to 3 to enable triple jump and so on, set to 0 to disable floor jump
default = 0; set to 1 to reset coordinate Y speed when jumping


Area Triggers allow objects to only respond when the ninja is in a certain area of the map. This can apply to AI chasing drone, laser and chaingun drone, and even PlayerMods.

Placed after the playerMods, i.e. after six |'s
with multiple of the same type of triggerIDs being seperated by periods.

(x0,y0) and (x1,y1) form the rectangle area that triggers things, and the triggerIDs do the same thing as the door switch trigger.

You can make multiple area triggers by putting ; between two of the above.

Community content is available under CC-BY-SA unless otherwise noted.