{"id":26492877,"url":"https://github.com/guysuvijak/flyff-skill-simulator","last_synced_at":"2025-08-22T22:35:10.243Z","repository":{"id":270780389,"uuid":"895394088","full_name":"guysuvijak/flyff-skill-simulator","owner":"guysuvijak","description":"Flyff Skill Simulator is an open-source project developed using Next.js and React Flow technologies. The website serves as a simulator for planning and visualizing skill builds in the Flyff Universe server, allowing players to experiment with different skill combinations and paths.","archived":false,"fork":false,"pushed_at":"2025-07-18T14:28:57.000Z","size":13461,"stargazers_count":18,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-18T14:52:50.151Z","etag":null,"topics":["flyff-universe","nextjs","react-flow","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://flyffskillsimulator.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guysuvijak.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-28T06:02:16.000Z","updated_at":"2025-07-18T14:29:01.000Z","dependencies_parsed_at":"2025-07-18T12:53:17.070Z","dependency_job_id":null,"html_url":"https://github.com/guysuvijak/flyff-skill-simulator","commit_stats":null,"previous_names":["guysuvijak/flyff-skill-simulator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/guysuvijak/flyff-skill-simulator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysuvijak%2Fflyff-skill-simulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysuvijak%2Fflyff-skill-simulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysuvijak%2Fflyff-skill-simulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysuvijak%2Fflyff-skill-simulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guysuvijak","download_url":"https://codeload.github.com/guysuvijak/flyff-skill-simulator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysuvijak%2Fflyff-skill-simulator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271711468,"owners_count":24807698,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flyff-universe","nextjs","react-flow","tailwindcss","typescript"],"created_at":"2025-03-20T09:28:09.444Z","updated_at":"2025-08-22T22:35:10.226Z","avatar_url":"https://github.com/guysuvijak.png","language":"TypeScript","funding_links":["https://ko-fi.com/guysuvijak"],"categories":[],"sub_categories":[],"readme":"# Flyff Universe Skill Simulator\n\n![Project Banner](/public/metadata/manifest.png)\n\nA comprehensive skill build simulator for Flyff Universe, built with Next.js 15 and React Flow.\u003c/br\u003e\nPlan and visualize your character's skill build before investing in-game with our interactive skill tree.\u003c/br\u003e\nAll skill data is directly retrieved from [Flyff Universe API](https://api.flyff.com).\n\n## 🌟 Features\n\n- **Interactive Skill Tree**: Visualize skill paths and dependencies with React Flow\n- **All Classes Supported**: Complete skill trees for every class in Flyff Universe (Knight, Blade, Elementor, Ranger, Billposter, Ringmaster, Jester, Acrobat, Assist, Mercenary, Psychikeeper, Vagrant, Magician)\n- **Build Sharing \u0026 Loading**: Share your builds via URL or import/export JSON files\n- **Multi-Language Support**: Available in 12 languages (English, Thai, Japanese, Vietnamese, Chinese, Brazilian Portuguese, German, French, Indonesian, Korean, Spanish)\n- **Real-time Updates**: See skill effects, requirements, and character stats instantly\n- **Mobile Friendly**: Fully responsive design with PWA support\n- **Theme Customization**: Multiple theme colors and dark/light mode\n- **No Backend Required**: All data stored in URL parameters with LZ-string compression\n- **Screenshot Feature**: Capture and save your skill builds as images\n- **Character Level Management**: Dynamic skill point calculation based on character level\n\n![Project Demo](/public/metadata/demo.png)\n\n![Skill Description](/public/metadata/skill-description.png)\n\n## 🚀 Live Demo\n\nVisit: [Flyff Skill Simulator](https://flyff-skill-simulator.vercel.app)\n\n![Project Demo Live](/public/metadata/demo-live.gif)\n\n## 💻 Getting Started\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/guysuvijak/flyff-skill-simulator.git\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n# or\nyarn install\n# or\npnpm install\n```\n\n3. Run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n```\n\n4. Open http://localhost:3000 in your browser\n\n## 🛠️ Built With\n\n- \u003cimg src=\"https://avatars.githubusercontent.com/u/126103961\" title=\"Next.js 15\" alt=\"nextjs\" width=\"20\" height=\"20\"/\u003e **Next.js 15** - React Framework with App Router\n- \u003cimg src=\"https://avatars.githubusercontent.com/u/7106853\" title=\"React Flow\" alt=\"reactflow\" width=\"20\" height=\"20\"/\u003e **React Flow** - Interactive node-based skill tree visualization\n- \u003cimg src=\"https://avatars.githubusercontent.com/u/45790596\" title=\"Zustand\" alt=\"zustand\" width=\"20\" height=\"20\"/\u003e **Zustand** - Lightweight state management\n- \u003cimg src=\"https://avatars.githubusercontent.com/u/67109815\" title=\"Tailwind CSS\" alt=\"tailwindcss\" width=\"20\" height=\"20\"/\u003e **TailwindCSS** - Utility-first CSS framework\n- \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/4/4c/Typescript_logo_2020.svg\" title=\"TypeScript\" alt=\"typescript\" width=\"20\" height=\"20\"/\u003e **TypeScript** - Type safety and better development experience\n- **Shadcn UI** - Accessible UI components (Dialog, Dropdown, Select, Tooltip, etc.)\n- **Framer Motion** - Smooth animations and transitions\n- **Lucide React** - Beautiful icon library\n- **LZ-string** - Data compression for URL sharing\n\n## 🗺️ Project Structure\n\n```bash\nflyff-skill-simulator/\n├── public/                    # Static assets\n│   ├── data/                  # Static Flyff data (classes, skills)\n│   ├── images/class/          # Class icons and images\n│   ├── cursors/               # Custom cursor assets\n│   └── metadata/              # Demo images and screenshots\n├── src/\n│   ├── app/                   # Next.js App Router (layout, page)\n│   ├── components/            # React components\n│   │   ├── ui/                # shadcn/ui components\n│   │   ├── SkillNode.tsx      # Interactive skill nodes\n│   │   ├── Navbar.tsx         # Main navigation\n│   │   └── EdgeLabel.tsx      # Skill tree edge labels\n│   ├── stores/                # Zustand state management\n│   │   ├── classStore.ts      # Class selection state\n│   │   ├── skillStore.ts      # Skill data and levels\n│   │   ├── characterStore.ts  # Character stats\n│   │   └── websiteStore.ts    # UI settings and theme\n│   ├── hooks/                 # Custom React hooks\n│   ├── locales/               # Multi-language support (12 languages)\n│   ├── providers/             # Context providers\n│   ├── types/                 # TypeScript type definitions\n│   └── utils/                 # Utility functions\n│       ├── shareBuild.ts      # Build sharing and loading\n│       ├── skillUtils.ts      # Skill calculations\n│       └── classUtils.ts      # Class data handling\n```\n\n## 🌍 Supported Languages\n\n- 🇺🇸 English (en)\n- 🇹🇭 Thai (th)\n- 🇯🇵 Japanese (jp)\n- 🇻🇳 Vietnamese (vi)\n- 🇨🇳 Chinese Simplified (cns)\n- 🇧🇷 Brazilian Portuguese (br)\n- 🇩🇪 German (de)\n- 🇫🇷 French (fr)\n- 🇮🇩 Indonesian (id)\n- 🇰🇷 Korean (kr)\n- 🇪🇸 Spanish (sp)\n\n## 📱 PWA Features\n\n- **Offline Support** - Works without internet connection\n- **Installable** - Add to home screen on mobile devices\n- **Fast Loading** - Optimized with Next.js and caching\n- **Responsive Design** - Works perfectly on all screen sizes\n\n## 🔧 Development Scripts\n\n```bash\nnpm run dev      # Start development server\nnpm run build    # Build for production\nnpm run start    # Start production server\nnpm run lint     # Run ESLint\nnpm run format   # Format code with Prettier\nnpm run check    # Run lint and format check\n```\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📈 Version History\n\nCurrent version: **1.5.5f** (2025-07-20)\n\nSee [CHANGELOG.md](CHANGELOG.md) for detailed version history and updates.\n\n## 🙏 Acknowledgments\n\n- ☕ **Support the project**: [Buy me a coffee](https://ko-fi.com/guysuvijak)\n- ☎️ **Contact**: [Facebook](https://web.facebook.com/guy.suvijak) or [Discord](https://discord.com/users/220231582722555924)\n- 🌟 **Star the repository** if you find this project helpful!\n\n---\n\n**Made with ❤️ for the Flyff Universe community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguysuvijak%2Fflyff-skill-simulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguysuvijak%2Fflyff-skill-simulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguysuvijak%2Fflyff-skill-simulator/lists"}