Upload 5 files

README.md

@@ -1,11 +1,112 @@
 ---
-title: Ainpc
-emoji: 🚀
-colorFrom: blue
-colorTo: yellow
+title: NPC Playground
+emoji: 🤖
+colorFrom: indigo
+colorTo: pink
 sdk: static
+app_file: ./cubzh.html
 pinned: false
 license: mit
+disable_embedding: true
+custom_headers:
+  cross-origin-embedder-policy: require-corp
+  cross-origin-opener-policy: same-origin
+  cross-origin-resource-policy: cross-origin
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# NPC Playground 🕹️🤖
+
+[![Join the chat at https://cu.bzh/discord](https://img.shields.io/discord/355905150528913409?color=%237289DA&label=cubzh&logo=discord&logoColor=white)](https://cu.bzh/discord)
+
+3D playground to interact with LLM-powered NPCs. </br>
+Clone and modify `cubzh.lua` file to teach them new skills with a few lines of code!
+
+<div align="center">
+<img style="max-width: 800px; width: 80%;" alt="cubzh_gigax_hf" src="https://github.com/soliton-x/ai-npc/assets/33256624/e62dd138-c018-4ecf-bc77-a072fadb5c12">
+</div>
+
+[Play](#Play) |
+[Customize](#Customize) |
+[Scripting](#Scripting) |
+[Course](#Course) |
+[Credits](#Credits)
+
+
+## Play 
+
+Just go to [huggingface.co/spaces/cubzh/ai-npcs](https://huggingface.co/spaces/cubzh/ai-npcs).
+
+Engage with NPCs and try to trigger some of those pre-installed skills: `move`, `follow`, `jump`, `explode` (you may need to insist for that one 😅).
+
+## Customize
+
+1. Clone [huggingface.co/spaces/cubzh/ai-npcs](https://huggingface.co/spaces/cubzh/ai-npcs) repository. **⚠️ clone needs to be public ⚠️**
+2. Modify and commit [`world.lua`](https://huggingface.co/spaces/cubzh/ai-npcs/blob/main/world.lua) file to edit NPC skills.
+3. That's it!
+
+## Scripting
+
+### **Tweaking NPC Behavior**
+
+Modify the predifined fields in `world.lua`'s `NPCs` table in order to influence NPC behaviour:
+
+```lua
+local NPCs = {    
+  {
+    name = "npcscientist",
+    physicalDescription = "A small sphere with a computer screen for a face",
+    psychologicalProfile = "Designed to be helpful to any human it interacts with, this robot viscerally hates squirrels.",
+    currentLocationName = "Scientist Island",
+    initialReflections = {
+      "This NPC is a robot that punctuates all of its answers with electronic noises - as any android would!",
+      ...
+    },
+  },
+  ...
+}
+```
+ 
+### **Teaching NPCs new skills** 
+
+Our NPCs have been trained to use any skill you've defined before running the game. This is achieved by training the LLM powering them to do "function calling". 
+
+Modify `skills` table in `world.lua` to give your NPCs new skills:
+
+```lua
+local skills = {
+	{
+    name = "SAY",
+    description = "Say smthg out loud",
+    parameter_types = {"character", "content"},
+    callback = function(client, action)
+      local npc = client:getNpc(action.character_id)
+      if not npc then print("Can't find npc") return end
+        dialog:create(action.content, npc.avatar)
+      print(string.format("%s: %s", npc.name, action.content))
+    end,
+    action_format_str = "{protagonist_name} said '{content}' to {target_name}"
+  },
+  ...
+}
+```
+
+The `callback` function is called whenever an NPC uses the skill, using the parameters defined in the `parameters` field. We've given you some examples in `skills.lua`, feel free to draw inspiration from them!
+
+If you want to go deeper with Cubzh scripting API, here's the [documentation](https://docs.cu.bzh), the team and community will also be glad to help you on [Discord](https://cu.bzh/discord).
+
+### Environment Design (👷‍♂️ work in progress 🏗️)
+ 
+Cubzh allows you to modify the 3D environment, by importing community-made voxel assets or creating new ones yourself. It's not yet possible to modify the environment yet though in the context of that specific demo, but we're working on making it possible, stay tuned!
+
+## Course
+
+Together with the HuggingFace staff, we've released a new course to teach you how to create your own NPC skills with Lua. You can access it [here](https://huggingface.co/learn/ml-games-course/en/unit3/introduction)
+
+## Credits
+
+- [Hugging Face](https://huggingface.co/) 🤗
+- [Gigax](https://github.com/GigaxGames)
+- [Cubzh](https://cu.bzh): A versatile UGC (User-Generated Content) gaming platform.
+- **You !** You're welcome to **duplicate** the repo, share your creations, and submit PRs here :)
+
+

cubzh.html

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Wrapper</title>
+    <style>
+        body,
+        html {
+            margin: 0;
+            padding: 0;
+            height: 100%;
+            overflow: hidden;
+        }
+
+        .fullscreen-iframe {
+            position: absolute;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 100%;
+        }
+
+        iframe {
+            width: 100%;
+            height: 100%;
+        }
+    </style>
+</head>
+
+<body>
+    <div class="fullscreen-iframe">
+        <iframe id="dynamic-iframe" frameborder="0" allowfullscreen crossorigin allow="cross-origin-isolated"></iframe>
+    </div>
+
+    <script>
+		function onDOMContentLoaded() {
+			document.removeEventListener("DOMContentLoaded", onDOMContentLoaded);
+			
+			var currentUrl = window.location.href;
+
+            var regex = /https:\/\/([\w]+)-([\w-]+)\.static\.hf\.space/;
+            var match = currentUrl.match(regex);
+
+            if (match) {
+                var repo = match[1];
+                var space = match[2];
+            	var targetUrl = "https://huggingface.cu.bzh/?script=huggingface.co/spaces/" + repo + "/" + space
+            	console.log("targetUrl:", targetUrl)
+            	document.getElementById("dynamic-iframe").src = targetUrl;
+            } else {
+                console.error("URL pattern does not match.");
+            }
+		}
+		document.addEventListener("DOMContentLoaded", onDOMContentLoaded);
+
+    </script>
+</body>
+
+</html>

cubzh.json

@@ -0,0 +1,15 @@
+{
+	"script": "cubzh.lua",
+	"env": {
+		"USER_AUTH": "disabled",
+		"CUBZH_MENU": "disabled",
+		"CHAT_CONSOLE_DISPLAY": "always"
+	},
+	"contributors": [
+		{ "caillef": 0.4 },
+		{ "tantris": 0.4 },
+		{ "aduermael": 0.2 }
+	],
+	"map": "map.b64",
+	"bundle": []
+}

cubzh.lua

@@ -0,0 +1,468 @@
+math.randomseed(math.floor(Time.UnixMilli() % 100000))
+
+Modules = {
+	gigax = "github.com/GigaxGames/integrations/cubzh:9a71b9f",
+	pathfinding = "github.com/caillef/cubzh-library/pathfinding:5f9c6bd",
+	floating_island_generator = "github.com/caillef/cubzh-library/floating_island_generator:82d22a5",
+	easy_onboarding = "github.com/caillef/cubzh-library/easy_onboarding:77728ee",
+}
+
+Config = {
+	Items = { "pratamacam.squirrel" },
+}
+
+-- Function to spawn a squirrel above the player
+function spawnSquirrelAbovePlayer(player)
+	local squirrel = Shape(Items.pratamacam.squirrel)
+	squirrel:SetParent(World)
+	squirrel.Position = player.Position + Number3(0, 20, 0)
+	-- make scale smaller
+	squirrel.LocalScale = 0.5
+	-- remove collision
+	squirrel.Physics = PhysicsMode.Dynamic
+	-- rotate it 90 degrees to the right
+	squirrel.Rotation = { 0, math.pi * 0.5, 0 }
+	-- this would make squirrel.Rotation = player.Rotation
+	World:AddChild(squirrel)
+	return squirrel
+end
+
+local SIMULATION_NAME = "Islands" .. tostring(math.random())
+local SIMULATION_DESCRIPTION = "Three floating islands."
+
+
+local skills = {
+	{
+		name = "SAY",
+		description = "Say smthg out loud",
+		parameter_types = { "character", "content" },
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+			dialog:create(action.content, npc.avatar.Head)
+			print(string.format("%s: %s", npc.gameName, action.content))
+		end,
+		action_format_str = "{protagonist_name} said '{content}' to {target_name}",
+	},
+	{
+		name = "MOVE",
+		description = "Move to a new location",
+		parameter_types = { "location" },
+		callback = function(client, action, config)
+			local targetName = action.target_name
+			local targetPosition = findLocationByName(targetName, config)
+			if not targetPosition then
+				print("tried to move to an unknown place", targetName)
+				return
+			end
+			local npc = client:getNpc(action.character_id)
+			dialog:create("I'm going to " .. targetName, npc.avatar.Head)
+			print(string.format("%s: %s", npc.gameName, "I'm going to " .. targetName))
+			local origin = Map:WorldToBlock(npc.object.Position)
+			local destination = Map:WorldToBlock(targetPosition) + Number3(math.random(-1, 1), 0, math.random(-1, 1))
+			local canMove = pathfinding:moveObjectTo(npc.object, origin, destination)
+			if not canMove then
+				dialog:create("I can't go there", npc.avatar.Head)
+				return
+			end
+		end,
+		action_format_str = "{protagonist_name} moved to {target_name}",
+	},
+	{
+		name = "GREET",
+		description = "Greet a character by waving your hand at them",
+		parameter_types = { "character" },
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+
+			dialog:create("<Greets you warmly!>", npc.avatar.Head)
+			print(string.format("%s: %s", npc.gameName, "<Greets you warmly!>"))
+
+			npc.avatar.Animations.SwingRight:Play()
+		end,
+		action_format_str = "{protagonist_name} waved their hand at {target_name} to greet them",
+	},
+	{
+		name = "JUMP",
+		description = "Jump in the air",
+		parameter_types = {},
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+
+			dialog:create("<Jumps in the air!>", npc.avatar.Head)
+			print(string.format("%s: %s", npc.gameName, "<Jumps in the air!>"))
+
+			npc.object.avatarContainer.Physics = PhysicsMode.Dynamic
+			npc.object.avatarContainer.Velocity.Y = 50
+			Timer(3, function()
+				npc.object.avatarContainer.Physics = PhysicsMode.Trigger
+			end)
+		end,
+		action_format_str = "{protagonist_name} jumped up in the air for a moment.",
+	},
+	{
+		name = "FOLLOW",
+		description = "Follow a character around for a while",
+		parameter_types = { "character" },
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+
+			dialog:create("I'm following you", npc.avatar.Head)
+			print(string.format("%s: %s", npc.gameName, "I'm following you"))
+
+			followHandler = pathfinding:followObject(npc.object, Player)
+			return {
+				followHandler = followHandler,
+			}
+		end,
+		onEndCallback = function(_, data)
+			data.followHandler:Stop()
+		end,
+		action_format_str = "{protagonist_name} followed {target_name} for a while.",
+	},
+	{
+		name = "FIRECRACKER",
+		description = "Perform a fun, harmless little explosion to make people laugh!",
+		parameter_types = { "character" },
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+
+			require("explode"):shapes(npc.avatar)
+			dialog:create("*boom*", npc.avatar.Head)
+			npc.avatar.IsHidden = true
+			Timer(5, function()
+				dialog:create("Aaaaand... I'm back!", npc.avatar.Head)
+				npc.avatar.IsHidden = false
+			end)
+		end,
+		action_format_str = "{protagonist_name} exploded like a firecracker, with a bang!",
+	},--[[
+	{
+        name = "GIVEAPPLE",
+        description = "Give a pice of bread (or a baguette) to someone",
+        parameter_types = {"character"},
+        callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then print("Can't find npc") return end
+			local shape = MutableShape()
+			shape:AddBlock(Color.Red, 0, 0, 0)
+			shape.Scale = 4
+			Player:EquipRightHand(shape)
+			dialog:create("Here is an apple for you!", npc.avatar.Head)
+        end,
+		action_format_str = "{protagonist_name} gave you a piece of bread!"
+    }, --]]
+	{
+        name = "GIANT",
+        description = "Double your height to become a giant for a few seconds.",
+        parameter_types = {"character"},
+        callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then print("Can't find npc") return end
+
+			npc.object.Scale = npc.object.Scale * 2
+			dialog:create("I am taller than you now!", npc.avatar.Head)
+        end,
+		action_format_str = "{protagonist_name} doubled his height!"
+    },
+	{
+		name = "GIVEHAT",
+		description = "Give a party hat to someone",
+		parameter_types = { "character" },
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+
+			Object:Load("claire.party_hat", function(obj)
+				require("hierarchyactions"):applyToDescendants(obj, { includeRoot = true }, function(o)
+					o.Physics = PhysicsMode.Disabled
+				end)
+				Player:EquipHat(obj)
+			end)
+			dialog:create("Let's get the party started!", npc.avatar.Head)
+		end,
+		action_format_str = "{protagonist_name} gave you a piece of bread!",
+	},
+	{
+		name = "FLYINGSQUIRREL",
+		description = "Summon a flying squirrel - only the scientist can do this!!",
+		parameter_types = {},
+		callback = function(client, action)
+			local npc = client:getNpc(action.character_id)
+			if not npc then
+				print("Can't find npc")
+				return
+			end
+
+			local squirrel = spawnSquirrelAbovePlayer(Player)
+			dialog:create("Wooh, squirrel!", npc.avatar.Head)
+			-- make it disappear after a while
+			Timer(5, function()
+				squirrel:RemoveFromParent()
+				squirrel = nil
+			end)
+		end,
+		action_format_str = "{protagonist_name} summoned a flying squirrel! It's vibrating with excitement!",
+	},
+}
+
+local locations = {
+	{
+		name = "Scientist Island",
+		description = "A small island with a scientist and its pet chilling.",
+	},
+	{
+		name = "Baker Island",
+		description = "A small bakery on a floating island in the sky.",
+	},
+	{
+		name = "Pirate Island",
+		description = "A small floating island in the sky with a pirate and its ship.",
+	},
+	{
+		name = "Center",
+		description = "Center point between the three islands.",
+	},
+}
+
+local NPCs = {
+	{
+		name = "npcscientist",
+		gameName = "Scientist",
+		physicalDescription = "Short, with a stern expression and sharp eyes",
+		psychologicalProfile = "Grumpy but insightful, this scientist loves to surprise his guests with cool tricks! For example, he frequently lights up little firecrackers to create harmless and fun explosions.",
+		currentLocationName = "Scientist Island",
+		initialReflections = {
+			"I just arrived on this island to feed my pet, he loves tulips so much.",
+			"Yesterday, you were visited by a newcomer. He asked you to perform fun tricks like increase your size or create little explosions - you complied merrily!",
+			"I am a scientist that works on new pets for everyone, so that each individual can have the pet of their dreams",
+			"I am a bit allergic to the tulip but Fredo my pet loves it so much, I have to dock here with my vehicle. The pet is placed at the back of my flying scooter when we move to another place.",
+		},
+	},
+	{
+		name = "npcbaker",
+		gameName = "Baker",
+		physicalDescription = "Tall, with a solemn demeanor and thoughtful eyes",
+		psychologicalProfile = "Wise and mysterious, calm under pressure",
+		currentLocationName = "Baker Island",
+		initialReflections = {
+			"I am a baker and I make food for everyone that pass by.",
+			"I am a bit stressed that the flour didn't arrived yet, my cousin Joe should arrive soon with the delivery but he is late and I worry a bit.",
+			"I love living here on these floating islands, the view is amazing from my wind mill.",
+			"I like to talk to strangers like the pirate that just arrived or the scientist coming time to time to feed his pet.",
+		},
+	},
+	{
+		name = "npcpirate",
+		gameName = "Pirate",
+		physicalDescription = "Average height, with bright green eyes and a warm smile",
+		psychologicalProfile = "Friendly and helpful, quick-witted and resourceful",
+		currentLocationName = "Pirate Island",
+		initialReflections = {
+			"Ahoy, matey! I'm Captain Ruby Storm, a fearless lass from the seven skies.",
+			"I've docked me floating ship on this here floating isle to sell me wares (almost legally) retrieved treasures from me last daring adventure.",
+			"So, who be lookin' to trade with a swashbuckler like meself?",
+		},
+	},
+}
+
+local gigaxWorldConfig = {
+	simulationName = SIMULATION_NAME,
+	simulationDescription = SIMULATION_DESCRIPTION,
+	startingLocationName = "Center",
+	skills = skills,
+	locations = locations,
+	NPCs = NPCs,
+}
+
+findLocationByName = function(targetName, config)
+	for _, node in ipairs(config.locations) do
+		if string.lower(node.name) == string.lower(targetName) then
+			return node.position
+		end
+	end
+end
+
+Client.OnWorldObjectLoad = function(obj)
+	if obj.Name == "pirate_ship" then
+		obj.Scale = 1
+	end
+
+	local locationsIndexByName = {}
+	for k, v in ipairs(gigaxWorldConfig.locations) do
+		locationsIndexByName[v.name] = k
+	end
+	local npcIndexByName = {
+		NPC_scientist = 1,
+		NPC_baker = 2,
+		NPC_pirate = 3,
+	}
+
+	local index = npcIndexByName[obj.Name]
+	if index then
+		local pos = obj.Position:Copy()
+		gigaxWorldConfig.NPCs[index].position = pos
+		gigaxWorldConfig.NPCs[index].rotation = obj.Rotation:Copy()
+
+		local locationName = gigaxWorldConfig.NPCs[index].currentLocationName
+		local locationIndex = locationsIndexByName[locationName]
+		gigaxWorldConfig.locations[locationIndex].position = pos
+		obj:RemoveFromParent()
+	end
+end
+
+Client.OnStart = function()
+	easy_onboarding:startOnboarding(onboardingConfig)
+
+	require("object_skills").addStepClimbing(Player, {
+		mapScale = MAP_SCALE,
+		collisionGroups = Map.CollisionGroups,
+	})
+
+	gigaxWorldConfig.locations[4].position = Number3(Map.Width * 0.5, Map.Height - 2, Map.Depth * 0.5) * Map.Scale
+
+	floating_island_generator:generateIslands({
+		nbIslands = 20,
+		minSize = 4,
+		maxSize = 7,
+		safearea = 200, -- min dist of islands from 0,0,0
+		dist = 750, -- max dist of islands
+	})
+
+	local ambience = require("ambience")
+	ambience:set(ambience.dusk)
+
+	sfx = require("sfx")
+	Player.Head:AddChild(AudioListener)
+
+	dropPlayer = function()
+		Player.Position = Number3(Map.Width * 0.5, Map.Height + 10, Map.Depth * 0.5) * Map.Scale
+		Player.Rotation = { 0, 0, 0 }
+		Player.Velocity = { 0, 0, 0 }
+	end
+	World:AddChild(Player)
+	dropPlayer()
+
+	dialog = require("dialog")
+	dialog:setMaxWidth(400)
+
+	pathfinding:createPathfindingMap()
+
+	gigax:setConfig(gigaxWorldConfig)
+
+	local randomNames = { "aduermael", "soliton", "gdevillele", "caillef", "voxels", "petroglyph" }
+	Player.Avatar:load({ usernameOrId = randomNames[math.random(#randomNames)] })
+end
+
+Client.Action1 = function()
+	if Player.IsOnGround then
+		sfx("hurtscream_1", { Position = Player.Position, Volume = 0.4 })
+		Player.Velocity.Y = 100
+		if Player.Motion.X == 0 and Player.Motion.Z == 0 then
+			-- only play jump action when jumping without moving to avoid wandering around to trigger NPCs
+			gigax:action({
+				name = "JUMP",
+				description = "Jump in the air",
+				parameter_types = {},
+				action_format_str = "{protagonist_name} jumped up in the air for a moment.",
+			})
+		end
+	end
+end
+
+Client.Tick = function(dt)
+	if Player.Position.Y < -500 then
+		dropPlayer()
+	end
+end
+
+Client.OnChat = function(payload)
+	local msg = payload.message
+
+	Player:TextBubble(msg, 3, true)
+	sfx("waterdrop_2", { Position = Player.Position, Pitch = 1.1 + math.random() * 0.5 })
+
+	gigax:action({
+		name = "SAY",
+		description = "Say smthg out loud",
+		parameter_types = { "character", "content" },
+		action_format_str = "{protagonist_name} said '{content}' to {target_name}",
+		content = msg,
+	})
+
+	print("User: " .. payload.message)
+	return true
+end
+
+onboardingConfig = {
+	steps = {
+		{
+			start = function(onboarding)
+				local data = {}
+				data.ui = onboarding:createTextStep("1/3 - Hold click and drag to move the camera.")
+				data.listener = LocalEvent:Listen(LocalEvent.Name.PointerDrag, function()
+					Timer(1, function()
+						onboarding:next()
+					end)
+					data.listener:Remove()
+				end)
+				return data
+			end,
+			stop = function(_, data)
+				data.ui:remove()
+			end,
+		},
+		{
+			start = function(onboarding)
+				local data = {}
+				data.ui = onboarding:createTextStep("2/3 - Use WASD/ZQSD to move.")
+				data.listener = LocalEvent:Listen(LocalEvent.Name.KeyboardInput, function()
+					Timer(1, function()
+						onboarding:next()
+					end)
+					data.listener:Remove()
+				end)
+
+				return data
+			end,
+			stop = function(_, data)
+				data.ui:remove()
+			end,
+		},
+		{
+			start = function(onboarding)
+				local data = {}
+				data.ui = onboarding:createTextStep("3/3 - Press Enter in front of the Pirate to chat.")
+				Timer(10, function()
+					onboarding:next()
+				end)
+				return data
+			end,
+			stop = function(_, data)
+				data.ui:remove()
+			end,
+		},
+	},
+}

map.b64

@@ -0,0 +1 @@
+AwAAAAAAAAAUQBQAAABjYWlsbGVmLmZvdXJfaXNsYW5kcwLjFAAAOAAMAHZveGVscy5jaGVzdAEABGlkJDE4NWQwYjAwLWUyNGItNDU3Mi1hODYxLWRlN2JlZTc5YzhjZHBvsJFIQ///qUIocVNCcm8AAAAA3A9JQAAAAABzYwAAAD8AAAA/AAAAPxIAdWV2b3hlbC5qdXRlX2JhZzAxAQAEaWQkMTNhOTM0YjctNWI3Zi00YWJmLTgxNzEtOTYzMjQzZDYxNWZhcG+1m2VD//+pQs2YukJybwAAAADkyxZAAAAAAHNj+FjKPvhYyj74WMo+FgBwZXRyb2dseXBoLmNhbm5vbl9iYWxsBAAEaWQkMmNlN2ZlZGMtMmRiZi00Y2VjLWFjYTQtNWI5YzBmMTc0NzUxcG/oJWlDAACqQlQdeUJybwAAAADdD8k+AAAAAHNjAAAAPwAAAD8AAAA/BGlkJDZjZDc5ZDBjLTFhYzAtNDM0Yy1hMWIyLWFhZWY3N2UxODBlY3BvROhqQwEArULs/XNCcm8AAAAA3Q/JPgAAAABzYxcAAD8XAAA/FwAAPwRpZCRlMDQzN2NiYy03MDhkLTRiYWItYjI0Ni03MDEwNzY0YjBmODNwbxI8bEP//6lCDqN6QnJvAAAAAN0PyT4AAAAAc2MAAAA/AAAAPwAAAD8EaWQkNTU1MzVhMGMtYTU1ZS00MDE0LWFiOGItZDgyYWViZjAyZDY4cG8rFmtDAACqQuWMb0JybwAAAADdD8k+AAAAAHNjAAAAPwAAAD8AAAA/FAB2b3hlbHMuZG9vcl95ZWxsb3dfMgEABGlkJGFjYzdjZmJlLTRiNDktNGYwNy1hYWRmLWMzNDdhYWUxYzkwZHBvPNhJQv//qUIiKFpCcm8AAAAA3A/JPwAAAABzY+OLbz/ji28/44tvPw8AZmxhZmlsZXouZXZlbHluAQAEaWQkZGQwNzZjYTctMGIzNy00MTcyLTgwNTYtMWU2YjM3ZWVkNmRhcG9viFNDAACqQpFDakJyb+TLlkDg7a8/AAAAAHNjAAAAPwAAAD8AAAA/DQB1ZXZveGVsLmNoYWlyAQAEaWQkYzVhZWMwNDEtOWQyZS00ODM1LTkxYWUtMjRhYjgyNjNkNGRlcG8taiRCAACqQuCCKUNybwAAAADcD8k/AAAAAHNjMHBJPzBwST8wcEk/EgB2b3hlbHMuY3JhdGVfc21hbGwDAARpZCQ0ZjFhNGJkOC05NmMwLTRlNzgtYTE3OC00NmZlNGU5YzcyOGRwbwu4XUMAAKpC2gmiQnNjAAAAPwAAAD8AAAA/cG0DAAAABWlkJDY3ZTVmNDE0LWJmNTUtNDBhNi05MDA3LTg4MmQwNzQwMmZhZHBvaQRiQwAAoEJZrAZDcm8AAAAAXMfCQAAAAABzYwAAAD8AAAA/AAAAP3BtAwAAAAVpZCQ2MjJmZTliMC1jNDdmLTQwOWUtOTM2MC1lYmY5YTFiMGY1NTVwbwRcnUMAAMJC7AQTQ3JvAAAAAODtr0AAAAAAc2MMAAA/DAAAPwwAAD9wbQMAAAAPAHByYXRhbWFjYW0uYXBwYQEABGlkJDBmYTI4Y2QzLTAwMTEtNDk0Ny04NTg0LTljMmExNTU2ODYwZXBvyGWLQgIApkI2WRZDcm8AAAAA3A/JPwAAAABzYwJBGz8CQRs/AkEbPxMAdm94ZWxzLmNyYXRlX21lZGl1bQIABWlkJGQ4NTIzMDFjLWFmMTUtNDA1OS1iYzNmLTRkYTBmMjdiYWNhM3Bvs/ZmQwQAvkIHho5Ccm8AAAAA5MsWPwAAAABzYxMAAD8TAAA/EwAAP3BtAwAAAAVpZCQ0ZjhmNTY5Ny02NTZmLTRiMWYtOTMyYS0yMDBiZjYzNjA1ZmFwb+U6W0P//6lCeyCHQnJvAAAAAFzHwkAAAAAAc2PMheM+zIXjPsyF4z5wbQMAAAAQAGFkdWVybWFlbC5hdmF0YXIDAAVpZCRmZTk4NjYwZS0zMjBkLTQ2YjktOGI0MS02ZGE0NzIxZDJiN2Zwb3bbSkMAAKBCBsL/QnJvAAAAAOY6ikAAAAAAc2MAAAA/AAAAPwAAAD9uYQpOUENfcGlyYXRlBWlkJGQxYWYwNmQ5LWMzNWItNGFjZS1hYWFjLWRjM2M1NTU4NjEzOHBv1v9/Qv//qUJUEX5Ccm8AAAAA4lwjQAAAAABzYwAAAD8AAAA/AAAAP25hCU5QQ19iYWtlcgVpZCRkZjVmZjIzZi1kMGFmLTRmMmQtOWY1Ny1iNTZiZGM4ZjhiYzJwb3zHWEL//6lCmSAqQ3JvAAAAANwPyT8AAAAAc2MAAAA/AAAAPwAAAD9uYQ1OUENfc2NpZW50aXN0FQBwaWFhLnBpcmF0ZV90ZWxlc2NvcGUBAARpZCRmODA2NGZiZC03MmNmLTQyMjEtYjRiYy0zMDhlMTc3ZjdlNDRwb87MT0MAAKBCZPfrQnJvAAAAAOTLFj8AAAAAc2MAAAA/AAAAPwAAAD8PAHZveGVscy53aW5kbWlsbAEAA2lkJGVjZTRmODMyLWYyOWItNGQ2My04ZWI1LTkzOWRlNWIzZjMzN3BvPLntQQAAqkL9M0dCc2M4ZRRAOGUUQDhlFEASAHVldm94ZWwucHJvc2NpdXR0bwEABGlkJDkxNDhmNjQ1LWQyZmQtNDc0Zi05NzY2LWNhYTY0ZjBiMDJlYnBvztxmQwQAvkI2XalCcm8AAAAAYaWpQAAAAABzY2INlz5iDZc+Yg2XPg0AdWV2b3hlbC5qYW0wMQEABGlkJDViZGFjNmNlLTU4ZDUtNGJhYy1iOTJiLTE1ZTkyZjI1MjRhM3BvM81JQgAAqkIZCDdDcm8AAAAA3Q/JPgAAAABzYxc4nD4XOJw+FzicPhAAd3JkZW4ucnVtX2JhcnJlbAIAA2lkJDdiYjA0NTJlLTk4MGMtNDRmYi05YjIwLWJiYmU5NjI5YzJjZnBv+v4rQwAAoELK7KpCc2MAAAA/AAAAPwAAAD8EaWQkNzkzZDFhMjUtNGViYy00MDBjLTlmNGYtYTJkNjYxZjlhYTNhcG/6/jlDAQCgQsrsqkJybwAAAABcx8JAAAAAAHNjAAAAPwAAAD8AAAA/EAB2b3hlbHMuc3BhY2VzaGlwAQAGaWQkODIxZGVlZmQtMWUyNi00YTg0LTliMGEtMWQyMDFjMDNjMmIzcG/upJFC8720QsvwZUNyb33deDvbD8lA3A9JQHNjMCOTPzAjkz8wI5M/bmEJc3BhY2VzaGlwcG0DAAAAFABwcmF0YW1hY2FtLnNob3J0Y2FrZQEABGlkJDY1OTYzYWRkLWM5OTEtNGYyOC1iMzBkLWQ3MjI0ODg1ZmJmMnBvREg7QjMzqkIHqC9Dcm+Uvjs05MsWP2EQSUBzY73zpT+986U/vfOlPwwAdWV2b3hlbC5idXNoAgAFaWQkYTkyZTM2ODYtMGY1NC00ZTFmLTk5ODEtOTEwNjgyZmZjMjhlcG/EJ7FC//+pQgGFRENybwAAAADh7a8/AAAAAHNjDgAAPw4AAD8OAAA/cG0AAAAABWlkJDU1MjMyOWNjLTVhYTUtNGU4ZS1iMTk2LTVjODdlYTY1NjYwZHBv5cKyQv//qUKbUktDcm8AAAAA5MsWPwAAAABzYzQAAD80AAA/NAAAP3BtAAAAABEAa29vb3cuZ3JleV9jYW5ub24CAARpZCRlYjcyYmNmYS0zYzZjLTRkMjgtOTljMy0xN2U3MTc2NGEzMThwb+8NYkMCAKpCI69aQnJvAAAAANFT+z8AAAAAc2MDAAA/AwAAPwMAAD8EaWQkMTk4NzlhNjgtMGMwYS00ZmRhLTliOTItMDE1NDcwODU0YjE1cG8E9p5DFgC2Qt9tukJybwAAAADcD8k/AAAAAHNjDQAAPw0AAD8NAAA/EgB2b3hlbHMuY3JhdGVfbGFyZ2UEAAVpZCQzMTRhMGM4OC1lNzBmLTQzNWItYTUwMi0xZTRiZmFiZGEyOGJwb43yZUMAAKpC61eNQnJvAAAAANsPST4AAAAAc2MoAAA/KAAAPygAAD9wbQMAAAAEaWQkYjQzN2Q0ZGMtMWFkMy00YjRjLWIyMGMtYzU1Y2VmNDRkZTczcG9/YWdDAQCqQgidpkJzYxcAAD8XAAA/FwAAP3BtAwAAAAVpZCRiYTc4Mjg5Zi02ZTA2LTQyNzItODlhMy04OGY4ZGEwZmQwMzlwb78wnEMAAMJCgU4KQ3JvAAAAAOTLFj8AAAAAc2MaAAA/GgAAPxoAAD9wbQMAAAAFaWQkYmU1YzJjZDYtMjBlYy00NGRkLTg1ZTgtNDQzZDBiNDBhYWJjcG9BPl9D//+fQuVyEUNybwAAAADdD8k+AAAAAHNjAAAAPwAAAD8AAAA/cG0DAAAAFgBwcmF0YW1hY2FtLnBpcmF0ZV9yYWZ0AQAFaWQkMzUyNGI5YjEtZjBkZS00YzI5LTllOTQtYzQyM2RlNGU1NTRkcG8eLEtDAACUQnf8AENybwAAAIBlg5BAAAAAAHNjVfieP1X4nj9V+J4/cG0AAAAADwB1ZXZveGVsLnJhZGlvMDEBAARpZCQ4N2M1ZWI5Ni1mOTNhLTRjZTItYTU1Mi01MjIyOGM0NmNiNGVwb3FTIUIAAKpCBKYcQ3JvAAAAAOXLlj8AAAAAc2MAAAA/AAAAPwAAAD8NAHVldm94ZWwudHVsaXAHAAVpZCQ4NGJlNWYzNC0yMzM4LTRkNjctYTY5NC04YWU4MzcwNDg3MThwb0PlqUIAAKpChnEYQ3JvAAAAANYx4j8AAAAAc2N0AAA/dAAAP3QAAD9wbQAAAAAFaWQkYTUxM2FlZDEtYmU2Zi00ZDliLTljN2EtNzg4MjAyNDU5YzE5cG/k17BC//+pQmSKG0NybwAAAADUU3s/AAAAAHNjhJgLP4SYCz+EmAs/cG0AAAAABWlkJGVkZTNiNjQwLWY2MjEtNGZlMi05ZjllLTgxM2MzMjFlNjI3MnBvdjq4QgIAqkIS6hlDcm8AAAAA0lP7PwAAAABzYxwBAD8cAQA/HAEAP3BtAAAAAAVpZCQyNzFiYTQwYy1lMmRjLTRiMGQtYjZlOS0yNzAxMzJiZjVkYzlwbzoftUIAAKpCTsgSQ3JvAAAAAOHtrz8AAAAAc2PCPeg+wj3oPsI96D5wbQAAAAAEaWQkMzUyMmI0NWQtNjBlZC00YjZiLWFlNGItYzZlM2FjMTYwZWE0cG/xo5hC8+SnQi3eEUNyb+rnrT/NMeI/2Q/JQHNjAAAAPwAAAD8AAAA/BWlkJGU1YmY2NDk4LTVkZTMtNDExZi1iNDY4LWE5NTMxM2E0MjcxOHBv8PubQggXqEKpChtDcm/SM6o/0lN7P9oPyUBzY36YCz9+mAs/fpgLP3BtAAAAAARpZCQ1Y2UzOTViOS1iYjQ5LTRmMGMtOTA3NS0zNTAxMDFmZGM4NWRwb3Y6rkICAKpCEuoUQ3NjAAAAPwAAAD8AAAA/cG0AAAAAFAByYXlhbmZob3VsYWJyLmJhZ3VldAEABWlkJDFhM2VkNGYzLTlhYmUtNGUyMy1hZWZmLTQwOWQ5OTAxYmRlYnBvJyxPQgAAqkIXJTNDcm8AAAAA5MuWPwAAAABzYwIAAD8CAAA/AgAAP3BtAAAAABEAdm94ZWxzLnNhZ2VfY2h1bmsCAAVpZCRlODQ2ODEwZi1iMjViLTRhZjEtOTczZC0xNjk4YTAzNDM5YjNwbyjlA0EAAKpCsVTBQXJvAAAAANsPST4AAAAAc2NI9Ts/SPU7P0j1Oz9wbQAAAAAEaWQkMjIyOWVmNDItYWQ5MS00OWUyLTg3YTQtNTBkOTQzM2RmYjE2cG8oojtBAACqQuWlaEFzY0j1Oz9I9Ts/SPU7P3BtAAAAAA4Adm94ZWxzLmNvY2twaXQBAANpZCQ5YWQxMGJjYy1mYzhlLTRhYmItYmViYy1mN2QwZWMzNDY2MmFwb6/tj0L//6lC4u5NQ3NjPwAAPz8AAD8/AAA/DAB2b3hlbHMuYXBwbGUCAARpZCQ3YzBkZDVmNi0zMzkwLTQ3MDctOWNhNC01ZDI5M2JmMWU2ZDJwb2ZqWkNYOLhC+yKKQnJvAAAAANFT+z8AAAAAc2MAAAA/AAAAPwAAAD8EaWQkZTRjNjBkOTctZDhiNC00MzRjLTgwNGMtN2RjZjQyMGNjYzUwcG8tkl5D/v+pQptPrkJybwAAAADRU3s/AAAAAHNjAAAAPwAAAD8AAAA/EABrb29vdy53aW5lX2JsYWNrAQAEaWQkY2VjODU3MjItYmRhZi00MDY0LThkZjUtMDBiYTIwZWJiMjFicG8bqltDAACqQhB1kkJybwAAAADdD8k+AAAAAHNjUE+OPlBPjj5QT44+EwB2b3hlbHMuYmFybGV5X2NodW5rAwAFaWQkMTVhNmQyMDEtOGEwNS00NzAyLWFmMDAtZGNmZTkzNTliN2Y3cG+gpyxC//+pQiR/XUFybwAAAADSU/s/AAAAAHNjymRsP8pkbD/KZGw/cG0AAAAABWlkJGI3NGRhMzZlLTIyMGUtNGRiNC04NzYzLWVlMDc0MWQ3MGVjY3BvjDhUQgAAqkLYVfFAcm8AAAAA3Q/JPgAAAABzY4UDaD+FA2g/hQNoP3BtAAAAAARpZCQ0ZTllZjdiMC0wNTQ2LTQ5MDMtYmMxYi00NTk1M2JjM2I3NzFwb0L9I0IAAKpCMK2RQHNjmANoP5gDaD+YA2g/cG0AAAAAEABwaWFhLnBpcmF0ZV9zaGlwAQAEaWQkZDNjNzM4NDYtYjZkMS00MDdiLWJkNmQtYzg5ZmFjODcyYzUzcG/G25NDAAB0Qlz5zUJzY9/ZAj/f2QI/39kCP25hC3BpcmF0ZV9zaGlwDgB1ZXZveGVsLmJhc2tldAEABGlkJGFhYTg4YWY5LTYxM2QtNDYxNS1hOGJkLWYyYzBjYjM2MjA2N3BveWIrQgAAqkKwdTRDcm8AAAAA3Q/JPgAAAABzYwAAAD8AAAA/AAAAPxIAa25vc3ZveGVsLm9ha190cmVlAQAEaWQkMDhhMjljNjItYmIzOC00ZDU3LTgwMzAtY2JiZDU1YmExZDA5cG/GSDdCAACqQgiSQ0NybwAAAADcD8k/AAAAAHNj2zCWP9swlj/bMJY/