[SRV] refact(ScriptEngine): add abstract layer to scripts between Eng…

…ine and GameLogic

Now any Python IDE should detect exist wraps of exported objects and provide auto-indentation.
Engine_Geometry left without wraps for now. Also documentation wasn't added yet.

Documentation/ScriptEngine API [russian].txt

@@ -25,13 +25,13 @@ Object -> Item (Небольшой предмет) -> Gun -> Taser.
 Точки передачи управления (колбеки, которые вызывает движок):
 
 Модуль Map: FillMap()
-Модуль EngineHook: OnPlayerJoined()
+Модуль Engine.Hooks: OnPlayerJoined()
 // more soon
 
-
+	
 // * * * * *
 //
-// Модуль Engine_Server
+// Модуль Engine.Server
 //
 // * * * * *
 
@@ -75,7 +75,7 @@ ItemSpriteState(enumeration)
 
 // * * * * *
 //
-// Модуль Engine_World
+// Модуль Engine.World
 //
 // * * * * *
 
@@ -123,7 +123,9 @@ Object
 	Функции:
 		AddVerb(string id, function() action) - добавить действие объекту (можно запихать аргументом любую функцию без аргументов)
 		Update(duration timeDelta) - вызывается каждый такт обновления мира движком
-		InteractedBy(Object) - вызывается, когда вызвано взаимодействие с объектом другим объектом (щелкнули по объекту: в аргументе то, что было в руке или сама рука)
+		InteractedBy(Object) -> bool // вызывается, когда вызвано взаимодействие с объектом другим объектом (щелкнули по объекту: в аргументе то, что было в руке или сама рука)
+		BumpedTo(Object) -> bool // вызывается, когда объект натыкается на другой объект (пока это возможно только для объектов, которым явно задали speed). 
+								 // При Move объект не начинает двигаться в препятствие
 
 		IsCloseTo(Object) - проверяет, находится ли объект рядом с тем, который передан в аргументе
 		Move(Vec2i) - передвинуть объект в заданном направлении. Все компоненты вектора должны быть == 1 ({1, 0}, {1, 1} например)

GameLogic/Engine/Hooks.py

@@ -0,0 +1,6 @@
+from Engine.Server import Player
+from Objects.Creatures.Ghost import Ghostize
+
+def OnPlayerJoined(player: Player):
+	print(player.ckey + " has joined! Yay!")
+	player.AddVerb("ghost", Ghostize)

GameLogic/Engine/HooksRawArgs.py

@@ -0,0 +1,4 @@
+from Engine.Hooks import *
+
+def rawOnPlayerJoined(player):
+	OnPlayerJoined(Player(player))

GameLogic/Engine/Server.py

@@ -0,0 +1,52 @@
+from Engine_Server import *
+from Engine.World import World, Control
+
+from enum import Enum
+
+class Game(eGame):
+	def __new__(cls, parent):
+		return parent
+
+	@property
+	def world() -> World:
+		return World(eGGame.world)
+
+
+class Player(ePlayer):
+	def __new__(cls, parent):
+		return parent
+
+	@property
+	def ckey(self) -> str:
+		return super().ckey
+
+	@property
+	def control(self) -> Control:
+		return Control(super().control)
+
+	@control.setter
+	def control(self, value):
+		super(Player, self.__class__).control.fset(self, value)
+
+	def IsConnected(self) -> bool:
+		return super().IsConnected()
+
+
+class ResourceManager(eResourceManager):
+	def __new__(cls, parent):
+		return parent
+
+	def GetIcon(title, state) -> eIcon:
+		eGServer.RM.GetIcon(title, state)
+
+
+gServer = eGServer
+gGame = Game(eGGame)
+gRM = ResourceManager(eGServer.RM)
+
+
+class ItemSpriteState(eItemSpriteState):
+	DEFAULT			= eItemSpriteState.DEFAULT
+	ON_MOB			= eItemSpriteState.ON_MOB
+	IN_HAND_LEFT	= eItemSpriteState.IN_HAND_LEFT
+	IN_HAND_RIGHT	= eItemSpriteState.IN_HAND_RIGHT

GameLogic/Engine/Utils.py

@@ -0,0 +1,8 @@
+import contextlib
+from datetime import timedelta
+from typing import Callable
+
+from Engine_Server import eGGame
+
+def spawn(delay: timedelta, activity: Callable[[], None]) -> None:
+	eGGame.AddDelayedActivity(delay, activity)