mirror of
				https://github.com/MarioSpore/Grinch-AP.git
				synced 2025-10-21 20:21:32 -06:00 
			
		
		
		
	
		
			
	
	
		
			361 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
		
		
			
		
	
	
			361 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
|   | import logging | ||
|  | import time | ||
|  | import typing | ||
|  | from logging import Logger | ||
|  | from typing import Dict | ||
|  | 
 | ||
|  | from NetUtils import ClientStatus, NetworkItem | ||
|  | from worlds.AutoSNIClient import SNIClient | ||
|  | from .Items import start_id as items_start_id | ||
|  | from .Locations import start_id as locations_start_id | ||
|  | 
 | ||
|  | if typing.TYPE_CHECKING: | ||
|  |     from SNIClient import SNIContext | ||
|  | else: | ||
|  |     SNIContext = typing.Any | ||
|  | 
 | ||
|  | snes_logger: Logger = logging.getLogger("SNES") | ||
|  | 
 | ||
|  | SRAM_START: int = 0xE00000 | ||
|  | L2AC_ROMNAME_START: int = 0x007FC0 | ||
|  | L2AC_SIGN_ADDR: int = SRAM_START + 0x2000 | ||
|  | L2AC_GOAL_ADDR: int = SRAM_START + 0x2030 | ||
|  | L2AC_DEATH_ADDR: int = SRAM_START + 0x203D | ||
|  | L2AC_TX_ADDR: int = SRAM_START + 0x2040 | ||
|  | L2AC_RX_ADDR: int = SRAM_START + 0x2800 | ||
|  | 
 | ||
|  | enemy_names: Dict[int, str] = { | ||
|  |     0x00: "a Goblin", | ||
|  |     0x01: "an Armor goblin", | ||
|  |     0x02: "a Regal Goblin", | ||
|  |     0x03: "a Goblin Mage", | ||
|  |     0x04: "a Troll", | ||
|  |     0x05: "an Ork", | ||
|  |     0x06: "a Fighter ork", | ||
|  |     0x07: "an Ork Mage", | ||
|  |     0x08: "a Lizardman", | ||
|  |     0x09: "a Skull Lizard", | ||
|  |     0x0A: "an Armour Dait", | ||
|  |     0x0B: "a Dragonian", | ||
|  |     0x0C: "a Cyclops", | ||
|  |     0x0D: "a Mega Cyclops", | ||
|  |     0x0E: "a Flame genie", | ||
|  |     0x0F: "a Well Genie", | ||
|  |     0x10: "a Wind Genie", | ||
|  |     0x11: "an Earth Genie", | ||
|  |     0x12: "a Cobalt", | ||
|  |     0x13: "a Merman", | ||
|  |     0x14: "an Aqualoi", | ||
|  |     0x15: "an Imp", | ||
|  |     0x16: "a Fiend", | ||
|  |     0x17: "an Archfiend", | ||
|  |     0x18: "a Hound", | ||
|  |     0x19: "a Doben", | ||
|  |     0x1A: "a Winger", | ||
|  |     0x1B: "a Serfaco", | ||
|  |     0x1C: "a Pug", | ||
|  |     0x1D: "a Salamander", | ||
|  |     0x1E: "a Brinz Lizard", | ||
|  |     0x1F: "a Seahorse", | ||
|  |     0x20: "a Seirein", | ||
|  |     0x21: "an Earth Viper", | ||
|  |     0x22: "a Gnome", | ||
|  |     0x23: "a Wispy", | ||
|  |     0x24: "a Thunderbeast", | ||
|  |     0x25: "a Lunar bear", | ||
|  |     0x26: "a Shadowfly", | ||
|  |     0x27: "a Shadow", | ||
|  |     0x28: "a Lion", | ||
|  |     0x29: "a Sphinx", | ||
|  |     0x2A: "a Mad horse", | ||
|  |     0x2B: "an Armor horse", | ||
|  |     0x2C: "a Buffalo", | ||
|  |     0x2D: "a Bruse", | ||
|  |     0x2E: "a Bat", | ||
|  |     0x2F: "a Big Bat", | ||
|  |     0x30: "a Red Bat", | ||
|  |     0x31: "an Eagle", | ||
|  |     0x32: "a Hawk", | ||
|  |     0x33: "a Crow", | ||
|  |     0x34: "a Baby Frog", | ||
|  |     0x35: "a King Frog", | ||
|  |     0x36: "a Lizard", | ||
|  |     0x37: "a Newt", | ||
|  |     0x38: "a Needle Lizard", | ||
|  |     0x39: "a Poison Lizard", | ||
|  |     0x3A: "a Medusa", | ||
|  |     0x3B: "a Ramia", | ||
|  |     0x3C: "a Basilisk", | ||
|  |     0x3D: "a Cokatoris", | ||
|  |     0x3E: "a Scorpion", | ||
|  |     0x3F: "an Antares", | ||
|  |     0x40: "a Small Crab", | ||
|  |     0x41: "a Big Crab", | ||
|  |     0x42: "a Red Lobster", | ||
|  |     0x43: "a Spider", | ||
|  |     0x44: "a Web Spider", | ||
|  |     0x45: "a Beetle", | ||
|  |     0x46: "a Poison Beetle", | ||
|  |     0x47: "a Mosquito", | ||
|  |     0x48: "a Coridras", | ||
|  |     0x49: "a Spinner", | ||
|  |     0x4A: "a Tartona", | ||
|  |     0x4B: "an Armour Nail", | ||
|  |     0x4C: "a Moth", | ||
|  |     0x4D: "a Mega  Moth", | ||
|  |     0x4E: "a Big Bee", | ||
|  |     0x4F: "a Dark Fly", | ||
|  |     0x50: "a Stinger", | ||
|  |     0x51: "an Armor Bee", | ||
|  |     0x52: "a Sentopez", | ||
|  |     0x53: "a Cancer", | ||
|  |     0x54: "a Garbost", | ||
|  |     0x55: "a Bolt Fish", | ||
|  |     0x56: "a Moray", | ||
|  |     0x57: "a She Viper", | ||
|  |     0x58: "an Angler fish", | ||
|  |     0x59: "a Unicorn", | ||
|  |     0x5A: "an Evil Shell", | ||
|  |     0x5B: "a Drill Shell", | ||
|  |     0x5C: "a Snell", | ||
|  |     0x5D: "an Ammonite", | ||
|  |     0x5E: "an Evil Fish", | ||
|  |     0x5F: "a Squid", | ||
|  |     0x60: "a Kraken", | ||
|  |     0x61: "a Killer Whale", | ||
|  |     0x62: "a White Whale", | ||
|  |     0x63: "a Grianos", | ||
|  |     0x64: "a Behemoth", | ||
|  |     0x65: "a Perch", | ||
|  |     0x66: "a Current", | ||
|  |     0x67: "a Vampire Rose", | ||
|  |     0x68: "a Desert Rose", | ||
|  |     0x69: "a Venus Fly", | ||
|  |     0x6A: "a Moray Vine", | ||
|  |     0x6B: "a Torrent", | ||
|  |     0x6C: "a Mad Ent", | ||
|  |     0x6D: "a Crow Kelp", | ||
|  |     0x6E: "a Red Plant", | ||
|  |     0x6F: "La Fleshia", | ||
|  |     0x70: "a Wheel Eel", | ||
|  |     0x71: "a Skeleton", | ||
|  |     0x72: "a Ghoul", | ||
|  |     0x73: "a Zombie", | ||
|  |     0x74: "a Specter", | ||
|  |     0x75: "a Dark Spirit", | ||
|  |     0x76: "a Snatcher", | ||
|  |     0x77: "a Jurahan", | ||
|  |     0x78: "a Demise", | ||
|  |     0x79: "a Leech", | ||
|  |     0x7A: "a Necromancer", | ||
|  |     0x7B: "a Hade Chariot", | ||
|  |     0x7C: "a Hades", | ||
|  |     0x7D: "a Dark Skull", | ||
|  |     0x7E: "a Hades Skull", | ||
|  |     0x7F: "a Mummy", | ||
|  |     0x80: "a Vampire", | ||
|  |     0x81: "a Nosferato", | ||
|  |     0x82: "a Ghost Ship", | ||
|  |     0x83: "a Deadly Sword", | ||
|  |     0x84: "a Deadly Armor", | ||
|  |     0x85: "a T Rex", | ||
|  |     0x86: "a Brokion", | ||
|  |     0x87: "a Pumpkin Head", | ||
|  |     0x88: "a Mad Head", | ||
|  |     0x89: "a Snow Gas", | ||
|  |     0x8A: "a Great Coca", | ||
|  |     0x8B: "a Gargoyle", | ||
|  |     0x8C: "a Rogue Shape", | ||
|  |     0x8D: "a Bone Gorem", | ||
|  |     0x8E: "a Nuborg", | ||
|  |     0x8F: "a Wood Gorem", | ||
|  |     0x90: "a Mad Gorem", | ||
|  |     0x91: "a Green Clay", | ||
|  |     0x92: "a Sand Gorem", | ||
|  |     0x93: "a Magma Gorem", | ||
|  |     0x94: "an Iron Gorem", | ||
|  |     0x95: "a Gold Gorem", | ||
|  |     0x96: "a Hidora", | ||
|  |     0x97: "a Sea Hidora", | ||
|  |     0x98: "a High Hidora", | ||
|  |     0x99: "a King Hidora", | ||
|  |     0x9A: "an Orky", | ||
|  |     0x9B: "a Waiban", | ||
|  |     0x9C: "a White Dragon", | ||
|  |     0x9D: "a Red Dragon", | ||
|  |     0x9E: "a Blue Dragon", | ||
|  |     0x9F: "a Green Dragon", | ||
|  |     0xA0: "a Black Dragon", | ||
|  |     0xA1: "a Copper Dragon", | ||
|  |     0xA2: "a Silver Dragon", | ||
|  |     0xA3: "a Gold Dragon", | ||
|  |     0xA4: "a Red Jelly", | ||
|  |     0xA5: "a Blue Jelly", | ||
|  |     0xA6: "a Bili Jelly", | ||
|  |     0xA7: "a Red Core", | ||
|  |     0xA8: "a Blue Core", | ||
|  |     0xA9: "a Green Core", | ||
|  |     0xAA: "a No Core", | ||
|  |     0xAB: "a Mimic", | ||
|  |     0xAC: "a Blue Mimic", | ||
|  |     0xAD: "an Ice Roge", | ||
|  |     0xAE: "a Mushroom", | ||
|  |     0xAF: "a Big Mushr'm", | ||
|  |     0xB0: "a Minataurus", | ||
|  |     0xB1: "a Gorgon", | ||
|  |     0xB2: "a Ninja", | ||
|  |     0xB3: "an Asashin", | ||
|  |     0xB4: "a Samurai", | ||
|  |     0xB5: "a Dark Warrior", | ||
|  |     0xB6: "an Ochi Warrior", | ||
|  |     0xB7: "a Sly Fox", | ||
|  |     0xB8: "a Tengu", | ||
|  |     0xB9: "a Warm Eye", | ||
|  |     0xBA: "a Wizard", | ||
|  |     0xBB: "a Dark Sum'ner", | ||
|  |     0xBC: "the Big Catfish", | ||
|  |     0xBD: "a Follower", | ||
|  |     0xBE: "the Tarantula", | ||
|  |     0xBF: "Pierre", | ||
|  |     0xC0: "Daniele", | ||
|  |     0xC1: "the Venge Ghost", | ||
|  |     0xC2: "the Fire Dragon", | ||
|  |     0xC3: "the Tank", | ||
|  |     0xC4: "Idura", | ||
|  |     0xC5: "Camu", | ||
|  |     0xC6: "Gades", | ||
|  |     0xC7: "Amon", | ||
|  |     0xC8: "Erim", | ||
|  |     0xC9: "Daos", | ||
|  |     0xCA: "a Lizard Man", | ||
|  |     0xCB: "a Goblin", | ||
|  |     0xCC: "a Skeleton", | ||
|  |     0xCD: "a Regal Goblin", | ||
|  |     0xCE: "a Goblin", | ||
|  |     0xCF: "a Goblin Mage", | ||
|  |     0xD0: "a Slave", | ||
|  |     0xD1: "a Follower", | ||
|  |     0xD2: "a Groupie", | ||
|  |     0xD3: "the Egg Dragon", | ||
|  |     0xD4: "a Mummy", | ||
|  |     0xD5: "a Troll", | ||
|  |     0xD6: "Gades", | ||
|  |     0xD7: "Idura", | ||
|  |     0xD8: "a Lion", | ||
|  |     0xD9: "the Rogue Flower", | ||
|  |     0xDA: "a Gargoyle", | ||
|  |     0xDB: "a Ghost Ship", | ||
|  |     0xDC: "Idura", | ||
|  |     0xDD: "a Soldier", | ||
|  |     0xDE: "Gades", | ||
|  |     0xDF: "the Master", | ||
|  | } | ||
|  | 
 | ||
|  | 
 | ||
|  | class L2ACSNIClient(SNIClient): | ||
|  |     game: str = "Lufia II Ancient Cave" | ||
|  | 
 | ||
|  |     async def validate_rom(self, ctx: SNIContext) -> bool: | ||
|  |         from SNIClient import snes_read | ||
|  | 
 | ||
|  |         rom_name: bytes = await snes_read(ctx, L2AC_ROMNAME_START, 0x15) | ||
|  |         if rom_name is None or rom_name[:4] != b"L2AC": | ||
|  |             return False | ||
|  | 
 | ||
|  |         ctx.game = self.game | ||
|  |         ctx.items_handling = 0b111  # fully remote | ||
|  | 
 | ||
|  |         ctx.rom = rom_name | ||
|  | 
 | ||
|  |         return True | ||
|  | 
 | ||
|  |     async def game_watcher(self, ctx: SNIContext) -> None: | ||
|  |         from SNIClient import snes_buffered_write, snes_flush_writes, snes_read | ||
|  | 
 | ||
|  |         rom: bytes = await snes_read(ctx, L2AC_ROMNAME_START, 0x15) | ||
|  |         if rom != ctx.rom: | ||
|  |             ctx.rom = None | ||
|  |             return | ||
|  | 
 | ||
|  |         if ctx.server is None or ctx.slot is None: | ||
|  |             # not successfully connected to a multiworld server, cannot process the game sending items | ||
|  |             return | ||
|  | 
 | ||
|  |         signature: bytes = await snes_read(ctx, L2AC_SIGN_ADDR, 16) | ||
|  |         if signature != b"ArchipelagoLufia": | ||
|  |             return | ||
|  | 
 | ||
|  |         # Goal | ||
|  |         if not ctx.finished_game: | ||
|  |             goal_data: bytes = await snes_read(ctx, L2AC_GOAL_ADDR, 10) | ||
|  |             if goal_data is not None and goal_data[goal_data[0]] == 0x01: | ||
|  |                 await ctx.send_msgs([{"cmd": "StatusUpdate", "status": ClientStatus.CLIENT_GOAL}]) | ||
|  |                 ctx.finished_game = True | ||
|  | 
 | ||
|  |         # DeathLink TX | ||
|  |         death_data: bytes = await snes_read(ctx, L2AC_DEATH_ADDR, 3) | ||
|  |         if death_data is not None: | ||
|  |             await ctx.update_death_link(bool(death_data[0])) | ||
|  |             if death_data[1] != 0x00: | ||
|  |                 snes_buffered_write(ctx, L2AC_DEATH_ADDR + 1, b"\x00") | ||
|  |                 if "DeathLink" in ctx.tags and ctx.last_death_link + 1 < time.time(): | ||
|  |                     player_name: str = ctx.player_names.get(ctx.slot, str(ctx.slot)) | ||
|  |                     enemy_name: str = enemy_names.get(death_data[1] - 1, hex(death_data[1] - 1)) | ||
|  |                     await ctx.send_death(f"{player_name} was totally defeated by {enemy_name}.") | ||
|  | 
 | ||
|  |         # TX | ||
|  |         tx_data: bytes = await snes_read(ctx, L2AC_TX_ADDR, 8) | ||
|  |         if tx_data is not None: | ||
|  |             snes_items_sent = int.from_bytes(tx_data[:2], "little") | ||
|  |             client_items_sent = int.from_bytes(tx_data[2:4], "little") | ||
|  |             client_ap_items_found = int.from_bytes(tx_data[4:6], "little") | ||
|  | 
 | ||
|  |             if client_items_sent < snes_items_sent: | ||
|  |                 location_id: int = locations_start_id + client_items_sent | ||
|  |                 location: str = ctx.location_names[location_id] | ||
|  |                 client_items_sent += 1 | ||
|  | 
 | ||
|  |                 ctx.locations_checked.add(location_id) | ||
|  |                 await ctx.send_msgs([{"cmd": 'LocationChecks', "locations": [location_id]}]) | ||
|  | 
 | ||
|  |                 snes_logger.info("New Check: %s (%d/%d)" % ( | ||
|  |                     location, | ||
|  |                     len(ctx.locations_checked), | ||
|  |                     len(ctx.missing_locations) + len(ctx.checked_locations))) | ||
|  |                 snes_buffered_write(ctx, L2AC_TX_ADDR + 2, client_items_sent.to_bytes(2, "little")) | ||
|  | 
 | ||
|  |             ap_items_found: int = sum(net_item.player != ctx.slot for net_item in ctx.locations_info.values()) | ||
|  |             if client_ap_items_found < ap_items_found: | ||
|  |                 snes_buffered_write(ctx, L2AC_TX_ADDR + 4, ap_items_found.to_bytes(2, "little")) | ||
|  | 
 | ||
|  |         # RX | ||
|  |         rx_data: bytes = await snes_read(ctx, L2AC_RX_ADDR, 4) | ||
|  |         if rx_data is not None: | ||
|  |             snes_items_received = int.from_bytes(rx_data[:2], "little") | ||
|  | 
 | ||
|  |             if snes_items_received < len(ctx.items_received): | ||
|  |                 item: NetworkItem = ctx.items_received[snes_items_received] | ||
|  |                 item_code: int = item.item - items_start_id | ||
|  |                 snes_items_received += 1 | ||
|  | 
 | ||
|  |                 snes_logger.info("Received %s from %s (%s) (%d/%d in list)" % ( | ||
|  |                     ctx.item_names[item.item], | ||
|  |                     ctx.player_names[item.player], | ||
|  |                     ctx.location_names[item.location], | ||
|  |                     snes_items_received, len(ctx.items_received))) | ||
|  |                 snes_buffered_write(ctx, L2AC_RX_ADDR + 2 * (snes_items_received + 1), item_code.to_bytes(2, 'little')) | ||
|  |                 snes_buffered_write(ctx, L2AC_RX_ADDR, snes_items_received.to_bytes(2, "little")) | ||
|  | 
 | ||
|  |         await snes_flush_writes(ctx) | ||
|  | 
 | ||
|  |     async def deathlink_kill_player(self, ctx: SNIContext) -> None: | ||
|  |         from SNIClient import DeathState, snes_buffered_write, snes_flush_writes | ||
|  | 
 | ||
|  |         # DeathLink RX | ||
|  |         if "DeathLink" in ctx.tags and ctx.last_death_link + 1 < time.time(): | ||
|  |             snes_buffered_write(ctx, L2AC_DEATH_ADDR + 2, b"\x01") | ||
|  |         else: | ||
|  |             snes_buffered_write(ctx, L2AC_DEATH_ADDR + 2, b"\x00") | ||
|  |         await snes_flush_writes(ctx) | ||
|  |         ctx.death_state = DeathState.dead |