# GitPull<\/p>\n
A plugin for Spigot\/Paper servers, used to execute pull operations from Git repositories.<\/p>\n
Supported Features:<\/p>\n
– `\/pull`: Pulls all configured repositories. ## Installation<\/p>\n 1. Place the plugin jar file into the server’s `plugins` directory. ## Commands<\/p>\n ### `\/pull`<\/p>\n Pulls all repositories defined in the configuration file.<\/p>\n ### `\/pull Pulls the repository with the specified name.<\/p>\n ### `\/pull reload`<\/p>\n Reloads the plugin configuration file.<\/p>\n ## Permissions<\/p>\n – `gitpull.pull`: Allows the execution of `\/pull` and `\/pull By default, both permissions are granted to `op`.<\/p>\n ## Configuration File<\/p>\n Configuration file path:<\/p>\n “`text Example configuration:<\/p>\n “`yml repositories: devpack: ### Global Configuration Items<\/p>\n #### `git-command`<\/p>\n The Git command to be invoked. Default is:<\/p>\n “`yml If the `git` executable cannot be found in the server’s environment variables, an absolute path can be provided, for example:<\/p>\n “`yml #### `clone-if-missing`<\/p>\n Whether to automatically execute `git clone` when the target directory is not a valid Git repository.<\/p>\n “`yml #### `timeout-seconds`<\/p>\n The timeout duration for a single repository operation, in seconds.<\/p>\n “`yml ### Repository Configuration Items<\/p>\n Each repository is defined under `repositories` and is distinguished by a unique name.<\/p>\n For example:<\/p>\n “`yml #### `repository`<\/p>\n The remote repository URL.<\/p>\n HTTPS is supported:<\/p>\n “`yml SSH is also supported:<\/p>\n “`yml #### `directory`<\/p>\n The local target directory for pulling.<\/p>\n – Absolute path: Uses the provided path directly. For example:<\/p>\n “`yml This will pull the data to `world\/datapacks\/AutoOP` under the server root directory.<\/p>\n #### `branch`<\/p>\n The branch to pull or clone. This field can be empty.<\/p>\n “`yml If left empty, the repository’s default branch will be used:<\/p>\n “`yml ## Usage Examples<\/p>\n ### Pull All Repositories<\/p>\n “`text ### Pull a Single Repository<\/p>\n “`text ### Reload Configuration<\/p>\n “`text ## Private Repositories<\/p>\n This plugin invokes the `git` executable on the server system, meaning private repository authentication relies strictly on the server machine’s local Git configuration.<\/p>\n Recommended methods:<\/p>\n ### 1. SSH Key<\/p>\n Format the repository URL as:<\/p>\n “`yml Then, configure an SSH key on the server machine and add the corresponding public key to your GitHub account or to the repository’s Deploy Keys.<\/p>\n ### 2. Git Credential Manager<\/p>\n If using HTTPS, you can manually execute a Git login operation once on the server machine to let the system remember the credentials. The plugin will then reuse them.<\/p>\n It is highly unrecommended to write the token directly in plain text within the configuration file:<\/p>\n “`yml ## Notes<\/p>\n – Repository names cannot be named `reload`. ## Logging Information<\/p>\n – Upon success, a success message will be displayed in the in-game chat or the server console. Pull the files from the git repository to the folder. \u4ecegit\u4ed3\u5e93\u62c9\u53d6\u6587\u4ef6\u5230\u6587\u4ef6\u5939\u3002<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"gitpull","_minecraft_project_id":"R3K4UT9Q","_minecraft_author":"MooreFoss","_minecraft_license":"Apache-2.0","_minecraft_downloads":6,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gitpull.zip","_minecraft_size_bytes":19214,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:30:11.403478Z","_minecraft_date_created":"2026-03-29T06:14:08.382960Z","_minecraft_date_modified":"2026-03-20T14:45:46.037289Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gitpull","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-04T09:21:51+00:00","_minecraft_import_hash":"f85e7802460f8242b1d41a17769d0374","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,129],"mod_loader":[134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-75820","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-spigot","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/pull
\n– `\/pull reload`: Reloads the configuration file.
\n– Supports pulling multiple repositories into different directories respectively.
\n– Supports execution by OP (Server Operator) and the server console.
\n– Supports Tab completion for repository names and `reload`.<\/p>\n
\n2. Start the server once to generate the default configuration file.
\n3. Edit `plugins\/gitpull\/config.yml`.
\n4. Execute `\/pull reload` to reload the configuration, or restart the server directly.<\/p>\n
\n– `gitpull.reload`: Allows the execution of `\/pull reload`.<\/p>\n
\nplugins\/gitpull\/config.yml
\n“`<\/p>\n
\ngit-command: git
\nclone-if-missing: true
\ntimeout-seconds: 300<\/p>\n
\n autoop:
\n repository: “https:\/\/github.com\/example\/repo.git”
\n directory: “world\/datapacks\/repo”
\n branch: “master”<\/p>\n
\n repository: “https:\/\/github.com\/example\/repo.git”
\n directory: “world\/datapacks\/dev”
\n branch: “dev”
\n“`<\/p>\n
\ngit-command: git
\n“`<\/p>\n
\ngit-command: “\/bin\/git”
\n“`<\/p>\n
\nclone-if-missing: true
\n“`<\/p>\n
\ntimeout-seconds: 300
\n“`<\/p>\n
\nrepositories:
\n example:
\n repository: “https:\/\/github.com\/example\/repo.git”
\n directory: “world\/datapacks\/repo”
\n branch: “master”
\n“`<\/p>\n
\nrepository: “https:\/\/github.com\/username\/repo.git”
\n“`<\/p>\n
\nrepository: “git@github.com:username\/repo.git”
\n“`<\/p>\n
\n– Relative path: Resolved relative to the server root directory.<\/p>\n
\ndirectory: “world\/datapacks\/AutoOP”
\n“`<\/p>\n
\nbranch: “master”
\n“`<\/p>\n
\nbranch: “”
\n“`<\/p>\n
\n\/pull
\n“`<\/p>\n
\n\/pull autoop
\n“`<\/p>\n
\n\/pull reload
\n“`<\/p>\n
\nrepository: “git@github.com:username\/private-repo.git”
\n“`<\/p>\n
\nrepository: “https:\/\/username:yourtoken@github.com\/username\/repo.git”
\n“`<\/p>\n
\n– When `\/pull` is executed for all repositories, they will be processed sequentially in the configured order.
\n– If a specific repository fails, it will not prevent subsequent repositories from executing.
\n– If a pull task is already running, any new `\/pull` requests will be rejected.
\n– If the target directory already exists, is not a Git repository, and is not empty, the plugin will not forcefully overwrite the directory.<\/p>\n
\n– Detailed `git stdout` (Standard Output) and `git stderr` (Standard Error) will be output to the server logs.
\n– After a batch pull is completed, the total number of successes and failures will be displayed.<\/p>\n","protected":false},"excerpt":{"rendered":"