docs: add warning for NativeAPI

chore: pre-release 0.8.3

Author: ShrBox

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.3] - 2024-07-14
+
+### Fixed
+
+- Fix Entity::hurt [#152]
+- Fix trident consumption for onSpawnProjectile [#143]
+
 ## [0.8.2] - 2024-07-12
 
 ### Fixed
@@ -443,8 +450,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#130]: https://github.com/LiteLDev/LegacyScriptEngine/issues/130
 [#134]: https://github.com/LiteLDev/LegacyScriptEngine/issues/134
 [#137]: https://github.com/LiteLDev/LegacyScriptEngine/issues/137
+[#143]: https://github.com/LiteLDev/LegacyScriptEngine/issues/143
 [#145]: https://github.com/LiteLDev/LegacyScriptEngine/issues/145
+[#152]: https://github.com/LiteLDev/LegacyScriptEngine/issues/152
 
+[0.8.3]: https://github.com/LiteLDev/LegacyScriptEngine/compare/v0.8.2...v0.8.3
 [0.8.2]: https://github.com/LiteLDev/LegacyScriptEngine/compare/v0.8.1...v0.8.2
 [0.8.1]: https://github.com/LiteLDev/LegacyScriptEngine/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/LiteLDev/LegacyScriptEngine/compare/v0.7.12...v0.8.0

docs/apis/NativeAPI/NativeFunction.md

@@ -1,5 +1,8 @@
 # NativeFunction
 
+!!! warning
+    NativeAPI has broken, don't use it in production environment
+
 This API set contains two types: `NativeFunction` and `NativeHook`, where `NativeHook` is a specialized implementation that only contains `call` and `address` properties.
 
 ### Symbol get function

docs/apis/NativeAPI/NativeFunction.zh.md

@@ -1,5 +1,8 @@
 # NativeFunction原生函数
 
+!!! warning
+    NativeAPI已损坏，请勿在生产环境中使用
+
 此API集包含如下两种类型`NativeFunction`和`NativeHook`，其中`NativeHook`为特化的实现，只包含`call`,`address`两个属性
 
 ### Symbol获得函数

docs/apis/NativeAPI/NativePointer.md

@@ -1,5 +1,8 @@
 # NativePointer
 
+!!! warning
+    NativeAPI has broken, don't use it in production environment
+
 This API is designed to help developers manipulate native pointers
 
 > Due to the x64 calling convention, any object (size>8) is passed by reference. To learn more details, please refer to [msdoc: x64 calling convention](https://docs.microsoft.com/cpp/build/x64-calling-convention)

docs/apis/NativeAPI/NativePointer.zh.md

@@ -1,5 +1,8 @@
 # NativePointer原生指针
 
+!!! warning
+    NativeAPI已损坏，请勿在生产环境中使用
+
 此API旨在帮助开发者操作原生指针
 
 > 由于x64调用约定，任何对象(size>8)均以引用方式传递，欲要了解更多相关细节，请参考[msdoc: x64 calling convention](https://docs.microsoft.com/cpp/build/x64-calling-convention)

docs/apis/NativeAPI/Summary.md

@@ -1,7 +1,10 @@
-# 脚本层原生接口（FFI）
+# Script layer native interface (FFI)
 
-通过在脚本层提供FFI（Foreign Function Interface）相关接口，有助于简化小型修复插件的开发过程，并通过脚本引擎获得较为稳定的ABI，便于在多个版本之间共享插件
+!!! warning
+    NativeAPI has broken, don't use it in production environment
 
-> 此类API只适用于对非性能敏感的工作流程，对调用者拥有对原生语言较为透彻及准确的理解，否则极容易带来意外的情况。
-> 若需要高性能底层接口，请使用原生语言。
-> 由于FFI接口规范仍然在设计当中，接口等相关信息可能在没有通知的情况下随时改变。
+By providing FFI (Foreign Function Interface) related interfaces in the script layer, it helps to simplify the development process of small repair plugins, and obtain a more stable ABI through the script engine, which is convenient for sharing plugins across multiple versions
+
+> This kind of API is only suitable for workflows that are not performance sensitive, and the caller has a thorough and accurate understanding of the native language, otherwise it is very easy to cause unexpected situations.
+> If you need high-performance low-level interfaces, please use native languages.
+> Since the FFI interface specification is still under design, the interface and related information may change at any time without notice.

docs/apis/NativeAPI/Summary.zh.md

@@ -1,7 +1,10 @@
-# Script layer native interface (FFI)
+# 脚本层原生接口（FFI）
 
-By providing FFI (Foreign Function Interface) related interfaces in the script layer, it helps to simplify the development process of small repair plugins, and obtain a more stable ABI through the script engine, which is convenient for sharing plugins across multiple versions
+!!! warning
+    NativeAPI已损坏，请勿在生产环境中使用
 
-> This kind of API is only suitable for workflows that are not performance sensitive, and the caller has a thorough and accurate understanding of the native language, otherwise it is very easy to cause unexpected situations.
-> If you need high-performance low-level interfaces, please use native languages.
-> Since the FFI interface specification is still under design, the interface and related information may change at any time without notice.
+通过在脚本层提供FFI（Foreign Function Interface）相关接口，有助于简化小型修复插件的开发过程，并通过脚本引擎获得较为稳定的ABI，便于在多个版本之间共享插件
+
+> 此类API只适用于对非性能敏感的工作流程，对调用者拥有对原生语言较为透彻及准确的理解，否则极容易带来意外的情况。
+> 若需要高性能底层接口，请使用原生语言。
+> 由于FFI接口规范仍然在设计当中，接口等相关信息可能在没有通知的情况下随时改变。

manifest.json

@@ -4,7 +4,7 @@
     "type": "native",
     "description": "A plugin engine for running LLSE plugins on LeviLamina",
     "author": "LiteLDev",
-    "version": "0.8.2",
+    "version": "0.8.3",
     "dependencies": [
         {
             "name": "LegacyMoney"

src/legacy/api/NativeAPI.cpp

@@ -24,7 +24,11 @@ Concurrency::concurrent_unordered_map<std::string, NativeFunction> NativeFunctio
         return Local<Value>();                                                                                         \
     }
 
-Local<Value> NativeFunction::callNativeFunction(DCCallVM* vm, NativeFunction* funcSymbol, const Arguments& args) {
+Local<Value> NativeFunction::callNativeFunction(
+    DCCallVM*        vm,
+    NativeFunction*  funcSymbol,
+    const Arguments& args
+) { // It breaks sometime
     if (args.size() < funcSymbol->mParams.size()) {
         lse::getSelfPluginInstance().getLogger().error("Too Few arguments!");
         lse::getSelfPluginInstance().getLogger().error("In Component: NativeCall");
@@ -522,7 +526,7 @@ Local<Value> ScriptNativeFunction::hook(const Arguments& args) {
         hookSymbol->mNativeCallback,
         reinterpret_cast<ll::memory::FuncPtr*>(hookOriginl),
         ll::memory::HookPriority::Normal
-    );
+    ); // It's broken
     hookSymbol->mFunction = hookOriginl;
     return scriptResult;
 }

tooth.json

@@ -1,7 +1,7 @@
 {
     "format_version": 2,
     "tooth": "github.com/LiteLDev/LegacyScriptEngine",
-    "version": "0.8.2",
+    "version": "0.8.3",
     "info": {
         "name": "LegacyScriptEngine",
         "description": "A plugin engine for running LLSE plugins on LeviLamina",
@@ -12,7 +12,7 @@
         ]
     },
     "dependencies": {
-        "gitea.litebds.com/LiteLDev/legacy-script-engine-lua": "0.8.2",
-        "gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs": "0.8.2"
+        "gitea.litebds.com/LiteLDev/legacy-script-engine-lua": "0.8.3",
+        "gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs": "0.8.3"
     }
 }