Objects: Difference between revisions

From Ukikipedia
Jump to navigation Jump to search
(fixing links)
(reformated the oibject group list)
 
(26 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{rewrite}}
{{rewrite}}


'''Objects''' are everything that exist in the world outside of the background and terrain. The maximum number of objects in a [[List of Courses|course]] is 240.
An '''object''' is an entity in the game that is not part of the level geometry of the course. Most objects either interact with Mario and/or move in some way, act as stationary platforms or simply exist for aesthetic purposes. The maximum number of objects in a [[List of Courses|course]] is 240.


Objects exist in two tiers: unimportant objects and important objects.
== Object Groups ==
Every object is part of a larger "group" that helps define its behavior<ref>[https://github.com/n64decomp/sm64/blob/master/src/game/object_list_processor.h#L32 Object Group Enumeration]</ref>. Of the 12 groups, some are more strongly defined than others, but they are still a useful tool to categorize objects in the game.


== Unimportant Objects ==
{| class=wikitable
Most special effects are unimportant objects. Some examples of unimportant objects are:
|-
* Smoke from being burned in lava
! Group Name
* Yellow Stars from ground pounds and headbonking
! Description
* Sparkles around a Koopa shell and a 1-UP
|-
* Dust from collecting [[Star|stars]] or ground pounding
|Player Group
* Wind particles
|The first group, this group is composed of "playable" characters, which is simply Mario. Had Luigi been finished, it's possible he would have been in this group.
|-
|Group 2
|This group is unused, it is possible this would have been a Luigi group, too.
|-
|Destructive
|The destructive group consists of (non-playable) objects able to destroy other objects. This group consists specifically of four objects- Bob-omb, Bob-omb explosion, cork shell, and a beta object that was unused.
|-
|Group 4
|Like the second group, this one is also unused.
|-
|General Actor
| This group contains most normal 'enemies' or actors ([[MIPS]], [[Bullet Bill]], [[Bully]], etc)
|-
|Pushable
|This group consists of objects able to push other (non-playable) objects. This behavior often goes along with [[transport cloning]]. This group consists of objects such as goomba, koopa, and spiny.
|-
|Level
|This group consists of objects within levels that are interactable, such as hearts and stars. This group often acts as "catch-all" along with default.
|-
|Group 7
|Group 7 is another unused group.
|-
|Default
|If an object isn't put into a different group, it ends up here. For this reason, this group acts as a "catch-all" for odd objects.
|-
|Surface
|These are any items that have surface collision, specifically walls, floor, and ceilings. Often these are items that would be easy to consider just part of the course geometry, such as the submarine in DDD or ship in JRB. Worth noting- this group is a requirement to have surfaces, so objects like Whomp and Thwomp still fall into this category despite being "actors".
|-
|Polelike
|The polelike group consists of objects that could be described as "radial" in that the attract Mario to some sort of radial center. This includes poles, whirlpools, tornados, trees, etc.
|-
|Spawner
|This group consists of most objects that spawn other objects, like coin spawners or star spawners.
|-
|Unimportant
|Unimportant objects generally do not affect gameplay at all and exist purely for visuals. This group has the unique quality of unloading to stay under the object limit, hence their "unimportant" name. Some examples include smoke, wind, and dust.
|}


== Important Objects ==
Every object that isn't unimportant is important. Some examples of important objects are:
* Characters
** [[Mario]]
** [[Toad]]
** [[Red Bob-omb]]
** [[Peach]]
* Coins of every type
** [[Yellow Coin]]
** [[Red Coins]]
** [[Blue Coins]]
* 1-UPs
* 1-UP checkpoints
* Power Stars
** [[100 Coin Star|100 Coins Stars]]
** [[8 Red Coins Star|8 Red Coins Stars]]
* Fire
* [[Caps]]
** [[Wing Cap]]
** [[Metal Cap]]
** [[Vanish Cap]]
* Cap/coin blocks
* Moving platforms and some stationary platforms
* Boxes of every type
* Trees of every type
* [[Cannons]] (Count as 2 objects: the blue base and the cannon barrel)
* Signs
* Coins' twinkles
* Dust from Mario walking or sliding
* Teleporters
* Water crystals


== Object Limit ==
 
The '''Object Limit''' is the maximum number of Important Objects a course can have loaded simultaneously before the game cannot handle loading any more. (Note: this doesn't apply to the total objects in the course, only to ones that are loaded at the time. Unloaded objects use no slots). As the object limit is approached, unimportant objects will sacrifice their slots in order to empty them for important objects. If no vacant slots are available when an important object is loaded, a [[Crash|crash]] will occur.
==Processing Order==
During a frame, object lists are processed in the following order: Spawner, Surface, Polelike, Player, Pushable, General, Destructive, Level, Default, Unimportant <ref>[https://github.com/n64decomp/sm64/blob/master/src/game/object_list_processor.c#L172 sObjectListUpdateOrder declaration]</ref>
 
== Object limit ==
The '''object limit''' is the maximum number of important objects a course can have loaded simultaneously before the game cannot handle loading any more. This limit is 240 at all times, but the [[debug]] code that displays object count fails to count certain spawners<sup>which?</sup>, making this limit seem lower in some courses<sup>citation needed</sup>. This doesn't apply to the total objects in the course, only to ones that are loaded at the time. Unloaded objects use no slots. As the object limit is approached, unimportant objects will sacrifice their slots in order to empty them for important objects. If no vacant slots are available when any object (important or unimportant) is loaded, a [[crash]] will occur.


== Trivia ==
== Trivia ==
* [[Clone|Clones]] never unload and thus occupy object slots even when the original object is unloaded.
* [[Clone|Clones]] never unload and thus occupy object slots even when the original object is unloaded.
* [[Parallel Universe|PUs]] don't naturally contain any objects, but they can be brought there.<ref>https://www.youtube.com/watch?v=AVtCM1B6iYk</ref>
* [[Parallel Universe|PUs]] don't naturally contain any objects, but they can be brought there.<ref>[https://www.youtube.com/watch?v=AVtCM1B6iYk "Bringing Objects to PUs" by UncommentatedPannen]</ref>


== See Also ==
== See also ==
* [[Object Slots]]
* [[Object Slot]]
* [[Game Freeze]]
* [[Game Freeze]]
* [[Parallel Universe]]
* [[Parallel Universe]]
Line 59: Line 70:
==References==
==References==
<references/>
<references/>
{{objects}}
{{DEFAULTSORT:Objects}}
{{DEFAULTSORT:Objects}}
[[Category:Objects]]

Latest revision as of 14:11, 11 October 2023

An object is an entity in the game that is not part of the level geometry of the course. Most objects either interact with Mario and/or move in some way, act as stationary platforms or simply exist for aesthetic purposes. The maximum number of objects in a course is 240.

Object Groups

Every object is part of a larger "group" that helps define its behavior[1]. Of the 12 groups, some are more strongly defined than others, but they are still a useful tool to categorize objects in the game.

Group Name Description
Player Group The first group, this group is composed of "playable" characters, which is simply Mario. Had Luigi been finished, it's possible he would have been in this group.
Group 2 This group is unused, it is possible this would have been a Luigi group, too.
Destructive The destructive group consists of (non-playable) objects able to destroy other objects. This group consists specifically of four objects- Bob-omb, Bob-omb explosion, cork shell, and a beta object that was unused.
Group 4 Like the second group, this one is also unused.
General Actor This group contains most normal 'enemies' or actors (MIPS, Bullet Bill, Bully, etc)
Pushable This group consists of objects able to push other (non-playable) objects. This behavior often goes along with transport cloning. This group consists of objects such as goomba, koopa, and spiny.
Level This group consists of objects within levels that are interactable, such as hearts and stars. This group often acts as "catch-all" along with default.
Group 7 Group 7 is another unused group.
Default If an object isn't put into a different group, it ends up here. For this reason, this group acts as a "catch-all" for odd objects.
Surface These are any items that have surface collision, specifically walls, floor, and ceilings. Often these are items that would be easy to consider just part of the course geometry, such as the submarine in DDD or ship in JRB. Worth noting- this group is a requirement to have surfaces, so objects like Whomp and Thwomp still fall into this category despite being "actors".
Polelike The polelike group consists of objects that could be described as "radial" in that the attract Mario to some sort of radial center. This includes poles, whirlpools, tornados, trees, etc.
Spawner This group consists of most objects that spawn other objects, like coin spawners or star spawners.
Unimportant Unimportant objects generally do not affect gameplay at all and exist purely for visuals. This group has the unique quality of unloading to stay under the object limit, hence their "unimportant" name. Some examples include smoke, wind, and dust.


Processing Order

During a frame, object lists are processed in the following order: Spawner, Surface, Polelike, Player, Pushable, General, Destructive, Level, Default, Unimportant [2]

Object limit

The object limit is the maximum number of important objects a course can have loaded simultaneously before the game cannot handle loading any more. This limit is 240 at all times, but the debug code that displays object count fails to count certain spawnerswhich?, making this limit seem lower in some coursescitation needed. This doesn't apply to the total objects in the course, only to ones that are loaded at the time. Unloaded objects use no slots. As the object limit is approached, unimportant objects will sacrifice their slots in order to empty them for important objects. If no vacant slots are available when any object (important or unimportant) is loaded, a crash will occur.

Trivia

  • Clones never unload and thus occupy object slots even when the original object is unloaded.
  • PUs don't naturally contain any objects, but they can be brought there.[3]

See also

References