{"id":24813750,"url":"https://github.com/quincyjo/stardrop","last_synced_at":"2025-06-24T23:05:32.284Z","repository":{"id":197285614,"uuid":"698360789","full_name":"quincyjo/stardrop","owner":"quincyjo","description":"Mod conversion and utility tool for Stardew Valley","archived":false,"fork":false,"pushed_at":"2025-02-03T21:43:49.000Z","size":114,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-24T23:05:18.826Z","etag":null,"topics":["stardew-mods","stardew-valley","stardewvalley","tool","tools"],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quincyjo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2023-09-29T18:33:47.000Z","updated_at":"2025-02-03T21:43:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"d06122d0-3233-4bdb-8eb7-a5ca22e6fe6b","html_url":"https://github.com/quincyjo/stardrop","commit_stats":null,"previous_names":["verbetam/stardrop","quincyjo/stardrop"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/quincyjo/stardrop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quincyjo%2Fstardrop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quincyjo%2Fstardrop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quincyjo%2Fstardrop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quincyjo%2Fstardrop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quincyjo","download_url":"https://codeload.github.com/quincyjo/stardrop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quincyjo%2Fstardrop/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261771110,"owners_count":23207218,"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","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":["stardew-mods","stardew-valley","stardewvalley","tool","tools"],"created_at":"2025-01-30T15:51:57.021Z","updated_at":"2025-06-24T23:05:32.243Z","avatar_url":"https://github.com/quincyjo.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stardrop\n\nStardrop is a modding tool for Stardew Valley mods. Specifically it is a tool for converting different types of custom\nentities and custom textures mods between the different type. This was originally started because I wanted to convert\nCustom Furniture [CF] to other mod types that I preferred, such as Alternative Textures [AT].\n\nIt also has capability to split and restitch sprite sheets across different styles, as well as re-adjusting the JSON\ninfo for the different mod types to use the different sprite sheet approaches. Reformatting a given mod that uses\ncombined spritesheets (large sprite sheets with many different sprites) into individual sprite sheets is a process which\nI have labeled as \"exploding\" the mod. The end result is the same in game, but the file structure is different and can\nbe easier to work with.\n\nThe current state of this project is as a personal project which I used locally, but I am taking steps to formalizing it\nand providing a more user friendly release. At present, this will take some effort to get familiar with and use. I plan\nand hopefully making some nice quality of life improvements and expanding this readme in the future.\n\n## Modules\n\nThis project contains several modules that published and available for use within your own project.\n\n### Core\n\nCore module contains the core models and utilities of the project. This includes base models for Stardrop entities and\nserialization tools.\n\n```scala\nlibraryDependencies += \"com.quincyjo\" %% \"stardrop-core\" % version\n```\n\n### Alternative Textures\n\nThis module contains the models and serialization tools for the Alternative Textures (AT) mod type.\n``\n\n```scala\nlibraryDependencies += \"com.quincyjo\" %% \"stardrop-alternative-textures\" % version\n```\n\n### Custom Furniture\n\nThis module contains the models and serialization tools for the Custom Furniture (CF) mod type.\n\n```scala\nlibraryDependencies += \"com.quincyjo\" %% \"stardrop-custom-furniture\" % version\n```\n\n### Content Patcher\n\nThis module contains the models for Content Patcher modes. This module is still a work in progress.\n\n```scala\nlibraryDependencies += \"com.quincyjo\" %% \"stardrop-content-patcher\" % version\n```\n\n### Converters\n\nFinally, the `stardrop-converters` module contains tools for converting between different mod types.\n\n```scala\nlibraryDependencies += \"com.quincyjo\" %% \"stardrop-converters\" % version\n```\n\n### Cli\n\nThe Cli module contains the command line interface for Stardrop and is not available as a dependency. Check\nthe [releases](https://github.com/quincyjo/stardrop/releases)\npage for the latest version or [built it from source](#building-cli-from-source) yourself.\n\n## Building CLI From Source\n\nThe SBT project comes with the [sbt-assembly](https://github.com/sbt/sbt-assembly) plugin which allows for the building\nof a fat JAR file.\n\nThis can be built by running the following SBT command from within the project directory. The resulting JAR file will be\nlocated at `./modules/cli/target/scala-2.13/stardrop.jar` assuming the CWD is the project root directory.\n\n```shell\nsbt cli/assembly\n```\n\n## Running the CLI JAR\n\nSee the available commands and their options.\n\n```shell\njava -jar ./stardrop.jar --help\n```\n\n### Common flow for converting a CF mod into an AT mod\n\n1. Exploding the Mod\n\nBy default, this will output the exploded mod into an `[root director name] exploded` subdirectory of the target mod\nroot.\n\n```shell\njava -jar ./stardrop.jar explode \\\n\"path/to/mod/root\" \\\n--expand-furniture-front --copy-fourth-rotation\n```\n\n2. Convert the exploded MOD to AT (after spot checking sprites, such as the different layers)\n\n```shell\njava -jar ./stardrop.jar convert --to AT \\\n\"path/to/mod/root/[root name] exploded\" --read-furniture-front\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquincyjo%2Fstardrop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquincyjo%2Fstardrop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquincyjo%2Fstardrop/lists"}