Objects: Difference between revisions
Jump to navigation
Jump to search
(→Object Limit: Fix some misinfo) |
(reformated the oibject group list) |
||
| (21 intermediate revisions by 12 users not shown) | |||
| Line 1: | Line 1: | ||
{{rewrite}} | {{rewrite}} | ||
''' | 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. | ||
== 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. | |||
= | {| class=wikitable | ||
|- | |||
! 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. | |||
|} | |||
== Object | |||
The ''' | ==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 | == See also == | ||
* [[Object | * [[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
| |||||||||||||||||||||||||||||