Yeni bir proje oluşturma

Pumpkin eklentileri, Cargo derleme sistemini kullanır.

Bu eklenti için tam kod, GitHub'da bir şablon olarak bulunabilir.

Yeni bir crate başlatma

Önce yeni bir proje klasörü oluşturmamız gerekiyor. Bunu, oluşturduğunuz klasörde şu komutu çalıştırarak yapabilirsiniz:

cargo new <project-name> --lib

Bu, içinde birkaç dosya bulunan bir klasör oluşturur. Klasör yapısı şöyle görünmelidir:

├── Cargo.toml
└── src
    └── lib.rs

Crate'i yapılandırma

Pumpkin eklentileri çalışma zamanında dinamik kütüphaneler olarak yüklendiği için, Cargo'ya bu crate'i bu şekilde derlemesini söylememiz gerekir.

Cargo.toml

[package]
name = "hello-pumpkin"
version = "0.1.0"
edition = "2024"

[lib] 
crate-type = ["cdylib"]

[dependencies]

Sonra bazı temel bağımlılıklar eklememiz gerekiyor. Pumpkin hâlâ erken geliştirme aşamasında olduğu için iç crate'ler crates.io'da yayımlanmıyor; bu yüzden Cargo'ya bağımlılıkları doğrudan GitHub'dan indirmesini söylemeliyiz.

Cargo.toml

[package]
name = "hello-pumpkin"
version = "0.1.0"
edition = "2024"

[lib]
crate-type = ["cdylib"]

[dependencies]
# This is the base crate with most high-level type definitions
pumpkin = { git = "https://github.com/Pumpkin-MC/Pumpkin.git", branch = "master", package = "pumpkin" } 
# Other utilities used by Pumpkin (e.g. TextComponent, Vectors...)
pumpkin-util = { git = "https://github.com/Pumpkin-MC/Pumpkin.git", branch = "master", package = "pumpkin-util" }
# Macros for easier plugin development
pumpkin-api-macros = { git = "https://github.com/Pumpkin-MC/Pumpkin.git", branch = "master", package = "pumpkin-api-macros" }

# A rust asynchronous runtime
tokio = "1.48"
# Logging
log = "0.4"

Daha iyi performance ve daha küçük dosya boyutları için Link-Time Optimization (LTO) etkinleştirmenizi öneririz.
Bunun derleme süresini artıracağını unutmayın.

Cargo.toml

[profile.release] 
lto = true

LTO'yu yalnızca release derlemeleri için etkinleştirir.