# ❤️ Heartopia Painting Tools | 心動小鎮繪畫工具

## 👉 Tool Introduction | 工具介紹

This tool is designed for Heartopia players, automatically converting uploaded images into pixel art format suitable for in-game painting, helping players easily create pixel-style artworks. When the developer reached level 14 in the game, they experienced the challenges of painting within the game firsthand, which inspired the creation of this program to help other art-loving players create more easily.\
本工具專為《心動小鎮》玩家設計，能將上傳的圖片自動轉換為遊戲內繪畫適用的點陣圖格式，幫助玩家輕鬆創作像素風格畫作。開發者剛升級至遊戲14級時，深感在遊戲內繪畫的挑戰，因而開發此程式，希望幫助同樣喜愛繪畫的玩家更輕鬆地創作。

## 👉 Main Features | 主要功能

- Multiple Image Ratios: Supports common ratios like 16:9, 4:3, 1:1, 3:4, 9:16
- Detail Level Selection: Four precision levels to meet different painting needs
- Game-native Colors: Uses only colors specified in the game to ensure artwork consistency
- Painting Assistance Tools: Built-in grid display and eyedropper tool for easy reference and detail adjustment
- Beginner-friendly: Step-by-step tutorials to help beginners get started quickly

- 多種圖片比例：支援 16:9、4:3、1:1、3:4、9:16 等常用比例
- 精細度選擇：四種等級設定，滿足不同繪畫需求
- 遊戲原生色彩：僅使用遊戲內指定顏色進行轉換，確保作品風格一致
- 繪畫輔助工具：內置網格顯示與滴管工具，便於對照與細節調整
- 新手友好：提供分步教程，協助初學者快速上手

## 👉 Usage Instructions | 使用說明

[Website Link | 網頁連結](https://zerochansy.github.io/Heartopia-Painting-Tools/) \
\
![image](https://github.com/zerochansy/Heartopia-Painting-Tools/blob/main/assets/preview/preview.jpg)
\
✅ Recommended to use the desktop version for the best experience.\
✅ All image processing is done locally on your device; no images are uploaded to any server, and no AI programs are used. Feel free to use your personal photos.\
\
✅ 建議使用電腦版本以獲得最佳體驗效果。\
✅ 本工具所有圖片處理均在本地進行，不會上傳至任何伺服器，亦不使用任何AI程序，請放心使用個人相片。

## 👉 About the Developer | 關於開發者


The developer is a designer and game developer, and also a dedicated 'Heartbeat Town' player. Welcome to visit and like my game island!\
開發者是一名設計師兼遊戲開發者，也是《心動小鎮》的忠實玩家。歡迎來我的遊戲小島點讚！\
\
Game ID | 遊戲ID - 162hkm95 (TW/HK/MO)\
[Instagram](https://www.instagram.com/zerochansy) [LinkedIn](https://www.linkedin.com/in/zerochansy/)


## ❤️ Support the Developer | ❤️ 支持開發者

If you find this tool helpful, consider supporting the developer with a donation～\
Your support gives the developer more motivation～\
如果覺得工具對你有幫助，歡迎打賞支持開發者～\
給予開發者更多的動力～\
\
👉 Paypal\
[My Paypal Account](https://www.paypal.com/paypalme/zerochansy)\
👉 WeChat Pay | 微信支付 \
![image](https://github.com/zerochansy/Heartopia-Painting-Tools/blob/main/assets/images/wechat_pay.jpg)


## Change Log

v1.0.7 - 20260305
- Added Thai language support, thank you [@Crapmoo](https://github.com/Crapmoo)

v1.0.6 - 20260204
- Remove the transparent color
- Prevent the color load twice
- Fix bug

v1.0.5 - 20260124
- Fix bug