| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  | import typing | 
					
						
							| 
									
										
										
										
											2022-03-12 22:05:54 +01:00
										 |  |  | import os | 
					
						
							|  |  |  | import json | 
					
						
							| 
									
										
										
										
											2022-02-15 19:56:10 +01:00
										 |  |  | from .Items import item_table, cannon_item_table, SM64Item | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | from .Locations import location_table, SM64Location | 
					
						
							|  |  |  | from .Options import sm64_options | 
					
						
							|  |  |  | from .Rules import set_rules | 
					
						
							| 
									
										
										
										
											2022-07-25 18:39:31 +02:00
										 |  |  | from .Regions import create_regions, sm64courses, sm64entrances_s, sm64_internalloc_to_string, sm64_internalloc_to_regionid | 
					
						
							| 
									
										
										
										
											2022-06-17 03:23:27 +02:00
										 |  |  | from BaseClasses import Item, Tutorial, ItemClassification | 
					
						
							| 
									
										
										
										
											2022-05-11 13:05:53 -05:00
										 |  |  | from ..AutoWorld import World, WebWorld | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-09-16 00:32:30 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-05-11 13:05:53 -05:00
										 |  |  | class SM64Web(WebWorld): | 
					
						
							|  |  |  |     tutorials = [Tutorial( | 
					
						
							|  |  |  |         "Multiworld Setup Guide", | 
					
						
							|  |  |  |         "A guide to setting up SM64EX for MultiWorld.", | 
					
						
							|  |  |  |         "English", | 
					
						
							|  |  |  |         "setup_en.md", | 
					
						
							|  |  |  |         "setup/en", | 
					
						
							|  |  |  |         ["N00byKing"] | 
					
						
							|  |  |  |     )] | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | class SM64World(World): | 
					
						
							|  |  |  |     """ 
 | 
					
						
							| 
									
										
										
										
											2022-01-23 21:45:43 +01:00
										 |  |  |     The first Super Mario game to feature 3D gameplay, it features freedom of movement within a large open world based on polygons, | 
					
						
							|  |  |  |     combined with traditional Mario gameplay, visual style, and characters. | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  |     """
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     game: str = "Super Mario 64" | 
					
						
							|  |  |  |     topology_present = False | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-05-11 13:05:53 -05:00
										 |  |  |     web = SM64Web() | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  |     item_name_to_id = item_table | 
					
						
							|  |  |  |     location_name_to_id = location_table | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-09-01 21:21:53 +02:00
										 |  |  |     data_version = 8 | 
					
						
							| 
									
										
										
										
											2022-10-13 10:46:44 +02:00
										 |  |  |     required_client_version = (0, 3, 5) | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  |     area_connections: typing.Dict[int, int] | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-08-15 16:46:59 -05:00
										 |  |  |     option_definitions = sm64_options | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  |     def generate_early(self): | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         self.topology_present = self.multiworld.AreaRandomizer[self.player].value | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  |     def create_regions(self): | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         create_regions(self.multiworld, self.player) | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |     def set_rules(self): | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  |         self.area_connections = {} | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         set_rules(self.multiworld, self.player, self.area_connections) | 
					
						
							| 
									
										
										
										
											2022-05-06 06:33:39 -05:00
										 |  |  |         if self.topology_present: | 
					
						
							|  |  |  |             # Write area_connections to spoiler log | 
					
						
							| 
									
										
										
										
											2022-07-25 18:39:31 +02:00
										 |  |  |             for entrance, destination in self.area_connections.items(): | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |                 self.multiworld.spoiler.set_entrance( | 
					
						
							| 
									
										
										
										
											2022-07-25 18:39:31 +02:00
										 |  |  |                     sm64_internalloc_to_string[entrance] + " Entrance", | 
					
						
							|  |  |  |                     sm64_internalloc_to_string[destination], | 
					
						
							| 
									
										
										
										
											2022-05-06 06:33:39 -05:00
										 |  |  |                     'entrance', self.player) | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |     def create_item(self, name: str) -> Item: | 
					
						
							|  |  |  |         item_id = item_table[name] | 
					
						
							| 
									
										
										
										
											2022-06-17 03:23:27 +02:00
										 |  |  |         if name == "1Up Mushroom": | 
					
						
							|  |  |  |             classification = ItemClassification.filler | 
					
						
							|  |  |  |         elif name == "Power Star": | 
					
						
							|  |  |  |             classification = ItemClassification.progression_skip_balancing | 
					
						
							|  |  |  |         else: | 
					
						
							|  |  |  |             classification = ItemClassification.progression | 
					
						
							|  |  |  |         item = SM64Item(name, classification, item_id, self.player) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  |         return item | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-04-08 02:03:28 +02:00
										 |  |  |     def create_items(self): | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         starcount = self.multiworld.AmountOfStars[self.player].value | 
					
						
							|  |  |  |         if (not self.multiworld.EnableCoinStars[self.player].value): | 
					
						
							|  |  |  |             starcount = max(35,self.multiworld.AmountOfStars[self.player].value-15) | 
					
						
							|  |  |  |         starcount = max(starcount, self.multiworld.FirstBowserStarDoorCost[self.player].value, | 
					
						
							|  |  |  |                         self.multiworld.BasementStarDoorCost[self.player].value, self.multiworld.SecondFloorStarDoorCost[self.player].value, | 
					
						
							|  |  |  |                         self.multiworld.MIPS1Cost[self.player].value, self.multiworld.MIPS2Cost[self.player].value, | 
					
						
							|  |  |  |                         self.multiworld.StarsToFinish[self.player].value) | 
					
						
							|  |  |  |         self.multiworld.itempool += [self.create_item("Power Star") for i in range(0,starcount)] | 
					
						
							|  |  |  |         self.multiworld.itempool += [self.create_item("1Up Mushroom") for i in range(starcount,120 - (15 if not self.multiworld.EnableCoinStars[self.player].value else 0))] | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         if (not self.multiworld.ProgressiveKeys[self.player].value): | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  |             key1 = self.create_item("Basement Key") | 
					
						
							|  |  |  |             key2 = self.create_item("Second Floor Key") | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |             self.multiworld.itempool += [key1, key2] | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  |         else: | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |             self.multiworld.itempool += [self.create_item("Progressive Key") for i in range(0,2)] | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |         wingcap = self.create_item("Wing Cap") | 
					
						
							|  |  |  |         metalcap = self.create_item("Metal Cap") | 
					
						
							|  |  |  |         vanishcap = self.create_item("Vanish Cap") | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         self.multiworld.itempool += [wingcap, metalcap, vanishcap] | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         if (self.multiworld.BuddyChecks[self.player].value): | 
					
						
							|  |  |  |             self.multiworld.itempool += [self.create_item(name) for name, id in cannon_item_table.items()] | 
					
						
							| 
									
										
										
										
											2022-02-15 19:56:10 +01:00
										 |  |  |         else: | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |             self.multiworld.get_location("BoB: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock BoB")) | 
					
						
							|  |  |  |             self.multiworld.get_location("WF: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock WF")) | 
					
						
							|  |  |  |             self.multiworld.get_location("JRB: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock JRB")) | 
					
						
							|  |  |  |             self.multiworld.get_location("CCM: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock CCM")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SSL: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock SSL")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SL: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock SL")) | 
					
						
							|  |  |  |             self.multiworld.get_location("WDW: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock WDW")) | 
					
						
							|  |  |  |             self.multiworld.get_location("TTM: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock TTM")) | 
					
						
							|  |  |  |             self.multiworld.get_location("THI: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock THI")) | 
					
						
							|  |  |  |             self.multiworld.get_location("RR: Bob-omb Buddy", self.player).place_locked_item(self.create_item("Cannon Unlock RR")) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         if (self.multiworld.ExclamationBoxes[self.player].value > 0): | 
					
						
							|  |  |  |             self.multiworld.itempool += [self.create_item("1Up Mushroom") for i in range(0,29)] | 
					
						
							| 
									
										
										
										
											2022-08-21 20:45:39 +02:00
										 |  |  |         else: | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |             self.multiworld.get_location("CCM: 1Up Block Near Snowman", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("CCM: 1Up Block Ice Pillar", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("CCM: 1Up Block Secret Slide", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("BBH: 1Up Block Top of Mansion", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("HMC: 1Up Block above Pit", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("HMC: 1Up Block Past Rolling Rocks", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SSL: 1Up Block Outside Pyramid", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SSL: 1Up Block Pyramid Left Path", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SSL: 1Up Block Pyramid Back", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SL: 1Up Block Near Moneybags", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("SL: 1Up Block inside Igloo", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("WDW: 1Up Block in Downtown", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("TTM: 1Up Block on Red Mushroom", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("THI: 1Up Block THI Small near Start", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("THI: 1Up Block THI Large near Start", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("THI: 1Up Block Windy Area", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("TTC: 1Up Block Midway Up", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("TTC: 1Up Block at the Top", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("RR: 1Up Block Top of Red Coin Maze", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("RR: 1Up Block Under Fly Guy", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("RR: 1Up Block On House in the Sky", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Bowser in the Dark World 1Up Block on Tower", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Bowser in the Dark World 1Up Block near Goombas", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Cavern of the Metal Cap 1Up Block", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Vanish Cap Under the Moat 1Up Block", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Bowser in the Fire Sea 1Up Block Swaying Stairs", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Bowser in the Fire Sea 1Up Block Near Poles", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Wing Mario Over the Rainbow 1Up Block", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							|  |  |  |             self.multiworld.get_location("Bowser in the Sky 1Up Block", self.player).place_locked_item(self.create_item("1Up Mushroom")) | 
					
						
							| 
									
										
										
										
											2022-08-21 20:45:39 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-05-19 09:37:26 -04:00
										 |  |  |     def get_filler_item_name(self) -> str: | 
					
						
							|  |  |  |         return "1Up Mushroom" | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  |     def fill_slot_data(self): | 
					
						
							|  |  |  |         return { | 
					
						
							| 
									
										
										
										
											2022-02-09 20:57:38 +01:00
										 |  |  |             "AreaRando": self.area_connections, | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |             "FirstBowserDoorCost": self.multiworld.FirstBowserStarDoorCost[self.player].value, | 
					
						
							|  |  |  |             "BasementDoorCost": self.multiworld.BasementStarDoorCost[self.player].value, | 
					
						
							|  |  |  |             "SecondFloorDoorCost": self.multiworld.SecondFloorStarDoorCost[self.player].value, | 
					
						
							|  |  |  |             "MIPS1Cost": self.multiworld.MIPS1Cost[self.player].value, | 
					
						
							|  |  |  |             "MIPS2Cost": self.multiworld.MIPS2Cost[self.player].value, | 
					
						
							|  |  |  |             "StarsToFinish": self.multiworld.StarsToFinish[self.player].value, | 
					
						
							|  |  |  |             "DeathLink": self.multiworld.death_link[self.player].value, | 
					
						
							| 
									
										
										
										
											2023-10-28 21:44:16 +02:00
										 |  |  |             "CompletionType" : self.multiworld.CompletionType[self.player].value, | 
					
						
							| 
									
										
										
										
											2022-01-23 21:34:30 +01:00
										 |  |  |         } | 
					
						
							| 
									
										
										
										
											2022-03-12 22:05:54 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |     def generate_output(self, output_directory: str): | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         if self.multiworld.players != 1: | 
					
						
							| 
									
										
										
										
											2022-03-12 22:05:54 +01:00
										 |  |  |             return | 
					
						
							|  |  |  |         data = { | 
					
						
							|  |  |  |             "slot_data": self.fill_slot_data(), | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |             "location_to_item": {self.location_name_to_id[i.name] : item_table[i.item.name] for i in self.multiworld.get_locations()}, | 
					
						
							| 
									
										
										
										
											2022-03-12 22:05:54 +01:00
										 |  |  |             "data_package": { | 
					
						
							|  |  |  |                 "data": { | 
					
						
							|  |  |  |                     "games": { | 
					
						
							|  |  |  |                         self.game: { | 
					
						
							|  |  |  |                             "item_name_to_id": self.item_name_to_id, | 
					
						
							|  |  |  |                             "location_name_to_id": self.location_name_to_id | 
					
						
							|  |  |  |                         } | 
					
						
							|  |  |  |                     } | 
					
						
							|  |  |  |                 } | 
					
						
							|  |  |  |             } | 
					
						
							|  |  |  |         } | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |         filename = f"{self.multiworld.get_out_file_name_base(self.player)}.apsm64ex" | 
					
						
							| 
									
										
										
										
											2022-03-12 22:05:54 +01:00
										 |  |  |         with open(os.path.join(output_directory, filename), 'w') as f: | 
					
						
							|  |  |  |             json.dump(data, f) | 
					
						
							| 
									
										
										
										
											2022-05-06 06:33:39 -05:00
										 |  |  | 
 | 
					
						
							|  |  |  |     def modify_multidata(self, multidata): | 
					
						
							|  |  |  |         if self.topology_present: | 
					
						
							|  |  |  |             er_hint_data = {} | 
					
						
							| 
									
										
										
										
											2022-07-25 18:39:31 +02:00
										 |  |  |             for entrance, destination in self.area_connections.items(): | 
					
						
							|  |  |  |                 regionid = sm64_internalloc_to_regionid[destination] | 
					
						
							| 
									
										
										
										
											2022-10-31 21:41:21 -05:00
										 |  |  |                 region = self.multiworld.get_region(sm64courses[regionid], self.player) | 
					
						
							| 
									
										
										
										
											2022-05-06 06:33:39 -05:00
										 |  |  |                 for location in region.locations: | 
					
						
							| 
									
										
										
										
											2022-07-25 18:39:31 +02:00
										 |  |  |                     er_hint_data[location.address] = sm64_internalloc_to_string[entrance] | 
					
						
							| 
									
										
										
										
											2022-05-06 06:33:39 -05:00
										 |  |  |             multidata['er_hint_data'][self.player] = er_hint_data |