PyTK - Platonymous Toolkit
⚪ Last updated 2023⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview

🔍 Analysis
- 👍 2.5% endorsement rate — high engagement, a strong quality signal
- 🏆 #9 of 119 Modding Tools mods in this game by downloads
📋 About This Mod
PyTK
by PlatonymousPyTK 1. 13. 29 + SMAPI 3. 4 changes to Map Edits
With SMAPI 3. 4 map edits made in Tiled, saved as TMX files and imported with TMXL, CP or the SMAPI API can now contain:
- Rotated and/or flipped tiles
- External .tsx tilesheets
With PyTK installed also supported are:
- Extra map layers (Add the custom layer-property "DrawAbove" or "DrawBefore" with the value of a vanilla layer name)
- Image-Layers (as extra layers, use offset to position)
- Opacity for layers & tiles
- BackgroundColor map property to set the color drawn behind the map.
- "@WaterColor" custom map property to set the color of the water on the map
- "@Color" custom layer/tile - property to tint layers and tiles
- Offsets for layers and tiles are supported but tiles, while drawn with the offset, will disappear and show in game based on their non-offset position.
Custom Objects that use PyTK. CEH, currently only work in single player or multiplayer if all players have the respective mod installed.
Changed save serializer Warning
SMAPI warns that this mod "may corrupt your save files, or make them unusable if you uninstall" it.
This is because PyTK accesses properties that COULD be used to change the serializer in that way, but doesn't actually change it.
So despite what the warning says, your save files will not be corrupted or become unusable when using or uninstalling this mod.
In development.
Adds a few new ways to use smapi.
Examples: https://github.com/Platonymous/Stardew-Valley-Mods/blob/master/PyTK/Examples.md
Source: https://github.com/Platonymous/Stardew-Valley-Mods/tree/master/PyTK
If you have any questions you can usually find me on the Stardew Valley Discord under the username Routine#8715
If you like my mods and want to support me, you can do so via Paypal or on Patreon.
PyTK is a foundational toolkit for Stardew Valley modders, providing shared libraries and utilities that other mods depend on. With 118,494 endorsements and 4.8 million downloads, it's a staple in the modding community, last updated in November 2023.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Massive community trust (118k endorsements) — this is the backbone of Stardew modding
- Essential for running many popular mods, so it's a must-have for modded playthroughs
- Regularly updated (last Nov 2023) to keep up with SMAPI changes
⚠️ Cons
- Not a standalone mod — does nothing on its own, so casual players might wonder why it's installed
- No detailed documentation in the description, so new modders may need to look elsewhere for usage info
- If you don't use mods that require it, it's just dead weight in your mods folder
For Stardew Valley players who install mods that depend on PyTK — you'll need this for them to work. Also for mod developers who want to build on a stable toolkit. Skip if you play vanilla or only use mods that don't require it.
💡 Beginner Tips
- Install PyTK with a mod manager like Vortex or manually drop it into your Mods folder — it's a simple drag-and-drop
- Make sure you have SMAPI installed first, as PyTK is a SMAPI mod and won't work without it
- If a mod says it requires PyTK, install this before the dependent mod to avoid load errors
📊 Mod Details
- Game
- Stardew Valley Mods
- Author
- Platonymous
- Version
- 1.24.0
- Downloads
- 4,762,201
- Endorsements
- 118,494
- Category
- Modding Tools
- Created
- 12/29/2017
- Updated
- 11/10/2023
🔧 How to Install Stardew Valley Mods
Download from Nexus.
📖 Full step-by-step install guide for Stardew Valley →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Stardew Valley commands, item IDs, and more.
Keep browsing — more Stardew Valley mods await