{"id":15016019,"url":"https://github.com/minecraftforge/bootstrap","last_synced_at":"2025-10-19T14:32:09.127Z","repository":{"id":203368061,"uuid":"701866997","full_name":"MinecraftForge/Bootstrap","owner":"MinecraftForge","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-09T18:03:54.000Z","size":290,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-29T18:38:18.474Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MinecraftForge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-header.txt","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},"funding":{"patreon":"LexManos"}},"created_at":"2023-10-07T19:46:40.000Z","updated_at":"2024-12-09T18:03:58.000Z","dependencies_parsed_at":"2023-12-29T23:25:48.701Z","dependency_job_id":"a4733d46-9aa7-47a0-aed2-87ec4cc09aac","html_url":"https://github.com/MinecraftForge/Bootstrap","commit_stats":{"total_commits":42,"total_committers":7,"mean_commits":6.0,"dds":0.4285714285714286,"last_synced_commit":"96b4c2132475dab21f6fa25e12d17057d0c5ee99"},"previous_names":["minecraftforge/bootstrap"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinecraftForge%2FBootstrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinecraftForge%2FBootstrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinecraftForge%2FBootstrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinecraftForge%2FBootstrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MinecraftForge","download_url":"https://codeload.github.com/MinecraftForge/Bootstrap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237152802,"owners_count":19263786,"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":[],"created_at":"2024-09-24T19:48:17.569Z","updated_at":"2025-10-19T14:32:08.797Z","avatar_url":"https://github.com/MinecraftForge.png","language":"Java","readme":"# Bootstrap\n\n\u003e Allows bootstrapping a modularized environment from a classpath one.\n\nBootstrap uses the following information:\n\n- The **(legacy) classpath information.** This is retrieved from the following, in descending order of priority:\n    - The `legacyClassPath.file` system property, containing a _path list_ (paths separated by `;` on Windows and `:` on\n      UNIX, as defined by [`File.pathSeparatorChar`][path_separator])\n    - The `legacyClassPath` system property, containing a path list\n    - The `java.class.path` system property.\n\n  If none of the above is present, then an exception is thrown.\n\n- The **ignore list**, specified by the `ignoreList` system property, as a comma-separated list of values. For any path\n  within the classpath (as retrieved above) whose filename begins with any value in the ignore list, the path is ignored\n  by BSL and not included in the bootstrap module layer created by BSL.\n\n  By default, the ignore list is set to ignore filenames that start with `asm` or `securejarhandler` (the dependencies\n  of BSL).\n\n- The optional **module merge information**, specified by the `mergeModules` system property. This is used to combine\n  multiple JAR files into a single logical module in the eyes of the module system. This property is a list of groups of\n  comma-separated paths, where each group is separated by semicolons and denotes one module.\n\n  For example: `a.jar,b.jar;b.jar,c.jar` means `a.jar` and `b.jar` are combined into one module, and `b.jar` and `c.jar`\n  are combined into another module.\n\n- The **bootstrap service**, which is a `Consumer\u003cString[]\u003e` service provided by a module in the bootstrap module layer.\n  At least one such bootstrap service must exist, otherwise an exception is thrown. [ModLauncher][modlauncher] provides\n  one such service: `BootstrapLaunchConsumer`.\n\nEach JAR (unless included in the above module merge information) maps to one module in the bootstrap module layer.\nBecause all modules share the same classloader, no module may share a package with another module. Therefore, packages\nare tracked and the first JAR which contains the module effectively 'owns' that package, and later JARs will not be\nsearched for the same package.\n\nBSL creates a new module layer which has the following properties:\n\n- The name of the module layer is `MC-BOOTSTRAP`.\n- Its parent layer and configuration is the boot configuration (from [`ModuleLayer#boot()`][bootmodule]).\n- It contains all the modules as provided in the classpath information (excluded from which the JARs who match the\n  ignore list) and mapped according to the optional module merge information.\n\nFor easier debugging, additional debugging information is printed to `System.out` if the `bsl.debug` system property is\ndefined (regardless of its actual value).\n\n## CLI args\nThe shim jar accepts the following arguments:\n- `--onlyCheckJava`: If specified, the shim will exit with success code 0 if the Java check passes rather than continuing to launch.\n\n[path_separator]: https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/io/File.html#pathSeparatorChar\n[modlauncher]: https://github.com/MinecraftForge/ModLauncher\n[bootmodule]: https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/ModuleLayer.html#boot()\n","funding_links":["https://patreon.com/LexManos"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminecraftforge%2Fbootstrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminecraftforge%2Fbootstrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminecraftforge%2Fbootstrap/lists"}