feat: take screenshot

src/creatures/players/player.hpp

@@ -1662,6 +1662,12 @@ class Player final : public Creature, public Cylinder, public Bankable {
 		}
 	}
 
+	void sendTakeScreenshot(uint8_t screenshotType) {
+		if (client) {
+			client->sendTakeScreenshot(screenshotType);
+		}
+	}
+
 	void onThink(uint32_t interval) override;
 
 	void postAddNotification(std::shared_ptr<Thing> thing, std::shared_ptr<Cylinder> oldParent, int32_t index, CylinderLink_t link = LINK_OWNER) override;

src/lua/functions/creatures/player/player_functions.cpp

@@ -4156,3 +4156,17 @@ int PlayerFunctions::luaPlayerKV(lua_State* L) {
 	setMetatable(L, -1, "KV");
 	return 1;
 }
+
+int PlayerFunctions::luaPlayerTakeScreenshot(lua_State* L) {
+	// player:takeScreenshot(screenshotType)
+	std::shared_ptr<Player> player = getUserdataShared<Player>(L, 1);
+	if (!player) {
+		lua_pushnil(L);
+		return 1;
+	}
+
+	auto screenshotType = getNumber<uint8_t>(L, 2);
+	player->sendTakeScreenshot(screenshotType);
+	pushBoolean(L, true);
+	return 1;
+}

src/lua/functions/creatures/player/player_functions.hpp

@@ -356,6 +356,8 @@ class PlayerFunctions final : LuaScriptInterface {
 
 		registerMethod(L, "Player", "kv", PlayerFunctions::luaPlayerKV);
 
+		registerMethod(L, "Player", "takeScreenshot", PlayerFunctions::luaPlayerTakeScreenshot);
+
 		GroupFunctions::init(L);
 		GuildFunctions::init(L);
 		MountFunctions::init(L);
@@ -706,5 +708,7 @@ class PlayerFunctions final : LuaScriptInterface {
 
 	static int luaPlayerKV(lua_State* L);
 
+	static int luaPlayerTakeScreenshot(lua_State* L);
+
 	friend class CreatureFunctions;
 };

src/server/network/protocol/protocolgame.cpp

@@ -8578,3 +8578,14 @@ void ProtocolGame::parseSaveWheel(NetworkMessage &msg) {
 
 	addGameTask(&Game::playerSaveWheel, player->getID(), msg);
 }
+
+void ProtocolGame::takeScreenshot(uint8_t screenshotType) {
+	if (!player || oldProtocol) {
+		return;
+	}
+
+	NetworkMessage msg;
+	msg.addByte(0x75);
+	msg.addByte(screenshotType);
+	writeToOutputBuffer(msg);
+}

src/server/network/protocol/protocolgame.hpp

@@ -502,6 +502,8 @@ class ProtocolGame final : public Protocol {
 	void sendSingleSoundEffect(const Position &pos, SoundEffect_t id, SourceEffect_t source);
 	void sendDoubleSoundEffect(const Position &pos, SoundEffect_t mainSoundId, SourceEffect_t mainSource, SoundEffect_t secondarySoundId, SourceEffect_t secondarySource);
 
+	void sendTakeScreenshot(uint8_t screenshotType);
+
 	uint8_t m_playerDeathTime = 0;
 
 	void resetPlayerDeathTime() {