pst-ui-tabs
DevelopmentEvery UI tab, dialog, and reusable widget in palworld_aio/ui/ and widgets/, plus the map rendering pipeline (MapGraphicsView/markers/items/effects). Load when editing UI, tabs, dialogs, the map, or Qt styling.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/deafdudecomputers/PalworldSaveTools/blob/HEAD/.opencode/skills/pst-ui-tabs/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pst-ui-tabs, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
PST UI Tabs, Dialogs, Widgets
"wsd" = constants.loaded_level_json['properties']['worldSaveData']['value']. Shared by all tabs.
The 9 tabs (QStackedWidget pages, MainWindow index order)
0. Tools — ui/tools_tab.py:244 (ToolsTab)
Landing/dashboard. Save-load card (button+drag-drop) + 4 StatIconBtn counters (navigate on click) + tool grids (Converting: json↔sav, game_pass_save_fix, convertids, restore_map; Management: slot_injector, modify_save, character_transfer, fix_host_save). _update_stats:362 reads wsd. _run_*_tool:434/459 import+call palworld_toolsets via _import_and_call:420. ConversionOptionsDialog(66).
1. Base Inventory — ui/base_inventory_tab.py:1661 (BaseInventoryTab)
Edit guild/base shared storage + view base-worker pals. Holds self.manager = BaseInventoryManager(). guild_button→base_button→content_stack[Inventory page (ContainerListWidget:717 + ContainerInfoWidget:939 + InventoryGridWidget) | BasePalsContentWidget:1261]. Auto-save 2s debounce (_trigger_auto_save:2452→_auto_save_changes:2455). Dialogs: GuildItemPickerDialog(51), GuildStructurePickerDialog(346), EconomyStatsDialog(604), ContainerSlotModificationDialog(648). 2606 lines — heaviest tab.
2. Player Inventory — ui/inventory_tab.py:789 (PlayerInventoryTab)
Full per-player inventory/equipment/stats editor. self.inventory = get_player_inventory(uid). inv_tabs QTabWidget = main_grid + key_grid + stats(StatsPanelWidget). Right equip_wrapper: EquipmentSlotWidget(105) grids (weapon×6, accessory×4, food×5, head/body/shield/glider/sphere_mod). Writes wsd ItemContainerSaveData via _update_raw_save_data(1715); stats via CharacterSaveParameterMap. _save_changes:1912 (memory only). Dialogs: ItemPickerDialog(628), InventoryLoadoutDialog(2068), QuantityDialog(1961). Emits saved, unlock_all_map_requested. 2203 lines.
3. Pal Editor — ui/pal_editor_tab.py:8 (PalEditorTab)
Thin host for edit_pals.PalEditorWidget. _show_editor:109 → PalEditorWidget.set_player(uid,name). Delegates everything. See pst-pal-editor skill for the editor engine.
4. Players — inline MainWindow (_setup_players_tab:315)
SearchPanel(search_players, 8 cols) + bulk-action toolbar (Bulk Item/Pal/Technology → dialogs). Right-click → _show_player_context_menu:1045 (ScrollableContextMenu: delete/rename/exclude/unlock cage/reset timestamp/container IDs/tech/level/guild ops). _refresh_players:709 → save_manager.get_players(), [L] leader prefix, pal counts, guild info.
5. Guilds — inline (_setup_guilds_tab:345)
QSplitter(Vertical) = guilds SearchPanel(3 cols) + members SearchPanel(5 cols). _on_guild_selected:1016 fills members via get_guild_members. Right-click → _show_guild_context_menu:1070 / _show_guild_member_context_menu:1086.
6. Bases — inline (_setup_bases_tab:360)
Single bases SearchPanel(4 cols). _refresh_bases:725 → get_bases(). Right-click → _show_base_context_menu:1105 (delete/export/import/clone/adjust radius/rename guild/set level).
7. Map — ui/map_tab.py:23 (MapTab)
Interactive world/tree map. QHBoxLayout = _map_widget (MapGraphicsView + overlay buttons) stretch3 + _sidebar_widget (search + QStackedWidget[base_tree|player_tree] + info_label) stretch2. refresh:796 → _get_guild_bases:809 (GroupSaveDataMap + BaseCampSaveData via palworld_coord.sav_to_map) + _get_players:876 (reads Players/*.sav LastTransform). _to_image_coordinates:920 maps world[-1000,1000]²→pixels. Toggles: bases/players/rings/zones/map-type/calibrate. Zone drawing (rect+polygon) via _set_zone_drawing_mode:1776. 1916 lines. See map rendering pipeline below.
8. Exclusions — inline (_setup_exclusions_tab:390)
3 SearchPanels (players/guilds/bases exclusions). _refresh_exclusions:734 reads constants.exclusions. Mutations _add_exclusion:1555/_remove_exclusion:1561, persisted via _save_exclusions:1491.
Map rendering pipeline (map_view/markers/items/effects)
MapGraphicsView (ui/map_view.py:8, QGraphicsView): QGraphicsScene holds single QGraphicsPixmapItem map image (z=-1, load_map loads T_WorldMap.webp/T_TreeMap.webp) + marker/zone/ring/effect items. Coord transform (mouseMoveEvent:208): x_world = img_x/width*2000-1000, y_world = 1000 - img_y/height*2000, then palworld_coord.map_to_sav/sav_to_map. Zoom (wheelEvent:100, factor 1.15, clamp 1.0-30.0), smooth zoom-to via animate_to_marker:268. Signals: marker_clicked/double_clicked/right_clicked, empty_space_right_clicked, zone*, zoom_changed, calibration_clicked.
Markers (ui/map_markers.py): BaseMarker:5 / PlayerMarker:122 (QGraphicsPixmapItem, ItemIgnoresTransformations). scale_to_zoom(zoom) dynamic sizing. Custom paint: animated "shine" sweep + QRadialGradient glow when selected/hovered. update_glow() pulse driven by MapTab._update_animations.
Map items (ui/map_items.py): BaseRadiusRing:4 (QGraphicsEllipseItem, save radius → scene pixels). ExclusionZoneItem:43 / PolygonExclusionZoneItem:125 (world↔scene via zone_manager.world_to_scene, red translucent). ZonePreviewItem:96 / PolygonPreviewItem:181 (live drag previews).
Effects (ui/map_effects.py): EffectItem:6 (QGraphicsObject, animated progress). DeleteEffect:23, ImportEffect:39, ExportEffect:88, CalibrationEffect:59. Played by MapTab._play_effect:1091 (QPropertyAnimation 0→1).
Header / Sidebar / Results
HeaderWidget (ui/header_widget.py:15): custom title bar. logo, menu_chip_btn (opens MenuPopup), version chip (pulses on update), game-version chip, info/warn/toolbox buttons, discord/min/max/close. Signals: minimize/maximize/close/about/toolbox_clicked.
SidebarWidget (ui/sidebar_widget.py:133, fixed 48px): 9 NavItem:47 buttons (NerdFont glyphs) → nav_changed(str). Bottom: console_toggled, right_panel_toggled. set_active() toggles indicator pill.
ResultsWidget (ui/results_widget.py:7, fixed 350px): right dashboard. "Selection & Stats" cards (set_player/guild/base) + StatsPanel (before/after/result counts). refresh_stats_before/after:123/128 from save_manager.get_current_stats().
Dialogs
| Dialog | file:line | Purpose |
|---|---|---|
| PlayerItemActionDialog | player_item_dialog.py:37 | Bulk add/remove item across players; find-players-with-item. Signals: item_action_selected, add_all_key_items_requested, add_all_effigies_requested, unlock_all_map_requested. |
| PlayerPalActionDialog | player_pal_dialog.py:21 | Delete pal species everywhere; remove skills from all pals. pal_action_selected. |
| PlayerTechnologyActionDialog | player_technology_dialog.py:14 | Add/remove tech per players. Edits Players/*.sav UnlockedRecipeTechnologyNames. |
| ContainerSelectorDialog | container_selector_dialog.py:17 | Reassign container IDs (fix broken inventories). get_selected_container_ids():666. |
| SkillPicker | skill_picker.py:120 | Searchable active/passive skill chooser. pick(). _PassiveSkillDelegate:13 animates rank≥4/5. |
| TabGuideDialog | tab_guide_dialog.py:67 | In-app help from tab_guide//*.html (10 sections). |
| ConversionOptionsDialog | tools_tab.py:66 | json↔sav direction picker. |
| ItemPickerDialog | inventory_tab.py:628 | Icon-grid item selector + qty. |
| ContainerSlotModificationDialog | base_inventory_tab.py:648 | Resize container slot count. |
| GuildItemPickerDialog/StructurePicker | base_inventory_tab.py:51/346 | Pick item/structure for bulk guild ops. |
| InventoryLoadoutDialog | inventory_tab.py:2068 | Save/load inventory presets. |
Reusable widgets (widgets/)
| Widget | file:line | Purpose |
|---|---|---|
| SearchPanel | search_panel.py:6 | title + search QLineEdit + sortable QTreeWidget. item_selected, add_item, get_selected_data, refresh_labels. Used by players/guilds/bases/exclusions. |
| StatsPanel | stats_panel.py:8 | before/after/result count grid + copy button. update_stats, refresh_stats_before/after. |
| MenuPopup | menu_popup.py:111 | main app menu (File/Functions/Maps/Exclusions/Updates/Languages). cursor-tracking submenu. ScrollableMenu:8. |
| ScrollableContextMenu | scrollable_context_menu.py:6 | scrollable context menu (long action lists). add_action, exec. |
| BaseHoverOverlay/PlayerHoverOverlay | base_hover_overlay.py:6 / player_hover_overlay.py:6 | map marker tooltips. show_for_base/player. |
| CollapsibleSplitter | collapsible_splitter.py:41 | splitter with toggle handle. collapsed_changed, collapse/expand. |
| LoadingPopup | loading_popup.py:3 | fade-in/out loading overlay. show_with_fade/hide_with_fade. |
| SortableTreeWidget | tree_widgets.py:5 | sortable tree + context_menu_requested signal. |
Styling
ui/styles.py: ThemeManager(:4, apply_global/apply_to_widget) + CSS constants (DIALOG_STYLE, MENU_STYLE, STATS_PANEL_STYLE, SLOT_STYLE) + helpers (slot_full, slot_rarity, wrap_tooltip_text).
ui/styled_combo.py:4 (StyledCombo): custom QComboBox replacement.
ui/menus.py: MenuFactory, ContextMenuBuilder, create_context_menu fns (MainWindow builds menus inline; these are alternatives).
resources/ui/themes/darkmode.qss: Qt dark theme stylesheet.
Cross-cutting
- i18n: every label uses
t('key', default=...); all tabs/dialogs implement refresh_labels() called from MainWindow._change_language:1494. - Game data: ItemData (items db), characters.json (pals icons/desc/passives), world.json technology, pal_exp_table.json. Icons under resources/game_data/icons/, map images T_WorldMap.webp/T_TreeMap.webp, game icons baseicon.webp/playericon.webp.
- Persistence: edits mutate in-memory + player .sav; disk flush via File→Save Changes → save_manager.save_changes(). Base-inventory auto-saves containers every 2s.