N
m (added links)
m (formatted for readability)
Line 44: Line 44:
   
   
zap drone, seeker drone (0):<br />
+
===zap drone, seeker drone (0)===
 
'''r'''<br />
 
'''r'''<br />
 
default = 6<br />
 
default = 6<br />
Line 50: Line 50:
   
   
laser drone (1):<br />
+
===laser drone (1)===
 
'''r'''<br />
 
'''r'''<br />
 
default = 6<br />
 
default = 6<br />
Line 63: Line 63:
 
default = 7; usage unknown
 
default = 7; usage unknown
   
[[List_of_NReality_Mods#Rotating_Laser_Drone|rotating laser drone]] (1):<br />
+
Modifications for the [[List_of_NReality_Mods#Rotating_Laser_Drone|rotating laser drone]]:<br />
 
startingAngle<br />
 
startingAngle<br />
 
default = 0; controls the angle at which it starts<br />
 
default = 0; controls the angle at which it starts<br />
Line 71: Line 71:
 
no default value; if set, the laser will always be a fixed number of pixels long and can go through walls
 
no default value; if set, the laser will always be a fixed number of pixels long and can go through walls
   
chaingun drone (2):<br />
+
===chaingun drone (2)===
 
'''r'''<br />
 
'''r'''<br />
 
default = 6
 
default = 6
Line 87: Line 87:
   
   
gold (3):<br />
+
===gold (3)===
 
'''r'''<br />
 
'''r'''<br />
 
default = 6
 
default = 6
   
   
bounceblock (4):<br />
+
===bounceblock (4)===
 
'''stiff'''<br />
 
'''stiff'''<br />
 
default = 0.05; controls the speed at which the block bounces back- very high or very low values may prevent it from doing so<br />
 
default = 0.05; controls the speed at which the block bounces back- very high or very low values may prevent it from doing so<br />
Line 103: Line 103:
   
   
launchpad (5):<br />
+
===launchpad (5)===
 
'''r'''<br />
 
'''r'''<br />
 
'''strength'''<br />
 
'''strength'''<br />
Line 109: Line 109:
   
   
gauss turret (6):<br />
+
===gauss turret (6)===
 
'''closeAimSpeed'''<br />
 
'''closeAimSpeed'''<br />
 
'''midAimSpeed'''<br />
 
'''midAimSpeed'''<br />
Line 127: Line 127:
   
   
floorguard (7):<br />
+
===floorguard (7)===
 
'''r'''<br />
 
'''r'''<br />
 
'''speed'''
 
'''speed'''
   
   
 
===thwump (11)===
oneway platform (10):<br />
 
(nothing)
 
 
 
thwump (11):<br />
 
 
(some apparently useless settings omitted)<br />
 
(some apparently useless settings omitted)<br />
 
'''xw'''<br />
 
'''xw'''<br />
Line 145: Line 141:
   
   
door (12):<br />
+
===door (12)===
 
'''doorsize'''<br />
 
'''doorsize'''<br />
 
'''r'''<br />
 
'''r'''<br />
Line 151: Line 147:
   
   
rocket launcher (13):<br />
+
===rocket launcher (13)===
 
'''speed'''<br />
 
'''speed'''<br />
 
'''maxspeed'''<br />
 
'''maxspeed'''<br />
Line 163: Line 159:
   
   
exit (14):<br />
+
===exit (14)===
 
'''r'''
 
'''r'''
   
   
mine (15):<br />
+
===mine (15)===
 
'''r'''
 
'''r'''
   
   
  +
===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.
 
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.
   

Revision as of 18:41, 3 July 2008

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:
|bgImage|fgImage|NRealityMapType|objectMod|playerMod

Player 03 has created a list of applications for NReality mods which can be found here.


bgImage, fgImage

Each of these slots will accept a link to an online image. The first image will be displayed in the background, and the second will be displayed in front of everything in the level.
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.

NRealityMapType

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

objectMod

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 must be a number between 0 and 15.
property indicates the property of the object to be modified.
modification indicates the new value of the property, and it must be a number.


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: floorguard
8: ninja
9: drone (note: may conflict with modifications made to 0, 1, and 2)
10: oneway platform
11: thwump
12: door
13: rocket launcher
14: exit
15: mine


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)

r
default = 6
speed


laser drone (1)

r
default = 6
speed
laserPrefireDelay
default = 30; determines the amount of time the drone will spend charging
laserPostfireDelay
default = 40; determines how long the drone will pause after firing
laserRate
default = 80; determines how long the drone will fire
laserLen default = 7; usage unknown

Modifications for the rotating laser drone:
startingAngle
default = 0; controls the angle at which it starts
rotateSpeed
default = 0.5; controls the speed and direction of rotation
fixedLaserLength
no default value; if set, the laser will always be a fixed number of pixels long and can go through walls

chaingun drone (2)

r
default = 6 speed
chaingunPrefireDelay
default = 35; determines the amount of time the drone will spend charging
chaingunPostfireDelay
default = 60; determines how long the drone will pause after firing
chaingunMaxNum
default = 8; usage unknown
chaingunRate
default = 6; usage unknown
chaingunSpread
default = 0.3; usage unknown


gold (3)

r
default = 6


bounceblock (4)

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


launchpad (5)

r
strength
default = 5.1428568; controls launchpad strength


gauss turret (6)

closeAimSpeed
midAimSpeed
farAimSpeed
aimSpeed
outerThreshold
innerThreshold
midThreshold
outerThreshold
midThreshold
innerThreshold
shotRate
shotTimer
fireDelayTimer
prefireDelay
postfireDelay


floorguard (7)

r
speed


thwump (11)

(some apparently useless settings omitted)
xw
yw
fallspeed
raisespeed
speed


door (12)

doorsize
r
maxtimer


rocket launcher (13)

speed
maxspeed
startaccel
curaccel
accelrate
turnrate
isHoming
prefireDelay
fireDelayTimer


exit (14)

r


mine (15)

r


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.
_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 red%.redMod.green%.greenMod.blue%.blueMod.transparent%.transparentMod. 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.

playerMod

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:

r
maxspeedAir
maxspeedGround
groundAccel
airAccel
normGrav
jumpGrav
normDrag
winDrag
wallFriction
skidFriction
standFriction
g
d
jumpAmt
jump_y_bias
max_jump_time
terminal_vel

Rotating Laser Drone

A rotating laser drone cannot be created through the standard method of modding. Instead, it must be made by modifying a laser drone's code. The standard code for a laser drone is 6^x,y,path,0,1,direction. To create a rotating laser drone, replace the fourth attribute with 1. This will not interfere with the code for standard laser drones, as that property was only used for zap/seeker drones.

See the objectMod section for information about modifications for the rotating laser drone.