Difference between revisions of "Player-World Interaction"
Jump to navigation
Jump to search
Hybrid Dog (talk | contribs) (Created page with "TODO == Digging a node == * first look at the node, it becomes pointed. Note that on android the node is pointed without looking (referring to the ...") |
Hybrid Dog (talk | contribs) |
||
| Line 10: | Line 10: | ||
== Digging a node == | == Digging a node == | ||
| − | * | + | Preconditions are a [[node]] somewhere in the [[world]]. |
| − | * Then [[LMB]] | + | This node is [[pointable]], has a selection box, and can be dug by the [[hand]] or the [[tool]] the [[player]] is wearing. |
| + | The player has interact [[priv]] and the tool has a [[tool range]] that the node can be pointed. | ||
| + | The node is not stuck somewhere the player can't point it. | ||
| + | |||
| + | * First look at the node, it becomes [[pointed_thing| pointed]]. | ||
| + | : Note that on [[android]] the node is pointed without looking (referring to the cross position) at it. | ||
| + | * Then [[LMB]] is pressed down while holding an item which does not have [[on_use]]. | ||
| + | : This makes the client send a punch event (client->interact(4, pointed), see game.cpp:3657 (28.02.2017)). | ||
| + | : On server side the punch event is passed to mods, see [[on_punch]] and the deprecated [[register_on_punchnode]]. | ||
| + | * Now continue looking at the node, i.e. keep pointing it, and hold down LMB. | ||
| + | : Periodically client-side digging particles are spawned (if not disabled in the settings) and the [[node dig sound]] is played. | ||
| + | :: The dig sound is either the "dig" field in the "sounds" [[register_node#Node_definition| table in the nodedef]] | ||
| + | :: or, if it's not present, the client uses the sound "default_dig_${groupname}" (file name extension omitted here), where $groupname is one of the groups the node has, see (I forgot where in the source code it was). | ||
| + | :: The default_dig_ thing should be banned from source code in my opinion. | ||
Revision as of 13:51, 28 February 2017
TODO
Digging a node
Preconditions are a node somewhere in the world. This node is pointable, has a selection box, and can be dug by the hand or the tool the player is wearing. The player has interact priv and the tool has a tool range that the node can be pointed. The node is not stuck somewhere the player can't point it.
- First look at the node, it becomes pointed.
- Note that on android the node is pointed without looking (referring to the cross position) at it.
- This makes the client send a punch event (client->interact(4, pointed), see game.cpp:3657 (28.02.2017)).
- On server side the punch event is passed to mods, see on_punch and the deprecated register_on_punchnode.
- Now continue looking at the node, i.e. keep pointing it, and hold down LMB.
- Periodically client-side digging particles are spawned (if not disabled in the settings) and the node dig sound is played.
- The dig sound is either the "dig" field in the "sounds" table in the nodedef
- or, if it's not present, the client uses the sound "default_dig_${groupname}" (file name extension omitted here), where $groupname is one of the groups the node has, see (I forgot where in the source code it was).
- The default_dig_ thing should be banned from source code in my opinion.