fix: make onPlaceBlock returning placing face and removing truePos pre calculation

fix: make onPlaceBlock returning place block face & edited docs

chore: update PlayerEvents.zh.md
fix: fix truePos

Author: VinkyV

docs/apis/EventAPI/PlayerEvents.md

@@ -396,12 +396,14 @@ Note: The player may trigger this event on the server multiple times in a row.
 #### `"onPlaceBlock"` - Player Try Places Block Event
 
 - Listener function prototype 
-  `function(player,block)`
+  `function(player,block,face)`
 - Parameters: 
   - player : `Player`  
     The player that placed the block.
   - block : `Block`  
-    The block that was placed.
+    The block that was placed on.
+  - face : `Integer`  
+    The face that was placed on.
 
 - Intercept events: function returns `false`
 

docs/apis/EventAPI/PlayerEvents.zh.md

@@ -407,20 +407,20 @@
 #### `"onPlaceBlock"` - 玩家尝试放置方块
 
 - 监听函数原型
-  `function(player,block)`
+  `function(player,block,face)`
 - 参数：
   - player : `Player`  
     放置方块的玩家对象
 
   - block : `Block`  
     将要放置的方块对象
 
+  - face : `Integer`  
+    被放置的方块的朝向。
+
 - 拦截事件：函数返回`false`
 
-> **存在问题** 
->
-> 1. 当玩家尝试放置方块时，该事件将持续被触发。
-> 2. 方块对象为准星对准的方块，并非将放置方块对象。
+> **存在问题** 当玩家尝试放置方块时，该事件将持续被触发。
 
 
 

src/legacy/api/EventAPI.cpp

@@ -276,7 +276,8 @@ void EnableEventListener(int eventId) {
                 CallEvent(
                     EVENT_TYPES::onPlaceBlock,
                     PlayerClass::newPlayer(&ev.self()),
-                    BlockClass::newBlock(ev.pos(), ev.self().getDimensionId())
+                    BlockClass::newBlock(truePos, ev.self().getDimensionId()),
+                    Number::newNumber((schar)ev.face())
                 );
             }
             IF_LISTENED_END(EVENT_TYPES::onPlaceBlock);