Java Plugin MusicAura

BananaMoc · Lúc 09:26:56

MusicAura

Nhạc tùy chỉnh • Thư viện nhạc cá nhân • Hiệu ứng hào quang • Phòng nhạc • Tích hợp kinh tế
MusicAura là một hệ thống âm nhạc dành cho Minecraft, được thiết kế cho các máy chủ Paper hiện đại muốn kết hợp nhạc tùy chỉnh, hiệu ứng particle trực quan, hệ thống sở hữu nhạc của người chơi và nền kinh tế trong game vào một hệ thống thống nhất.
Người chơi có thể sưu tầm, mua, phát và tặng nhạc. Mỗi bài hát có thể được cấu hình riêng về âm lượng, phạm vi nghe, hiệu ứng particle, chế độ lặp, thời gian phát hiệu ứng và nhiều thiết lập khác.
MusicAura sử dụng resource pack được máy chủ tạo tự động để phát âm thanh tùy chỉnh trực tiếp trong Minecraft mà không yêu cầu người chơi cài thêm client-side mod.

Tính năng

Phát nhạc tùy chỉnh

Thêm nhạc của riêng bạn vào máy chủ và cung cấp chúng cho người chơi thông qua MusicAura.
Các định dạng âm thanh được hỗ trợ:

.ogg
.mp3
.wav

MP3 và WAV có thể được xử lý thông qua FFmpeg, trong khi OGG có thể được sử dụng trực tiếp.
Mỗi bài hát có thể có các thiết lập riêng:

Tên hiển thị
Tác giả
Mô tả
Thể loại
Âm lượng
Phạm vi nghe
Chế độ lặp
Danh mục phát
Trạng thái khả dụng
Hiệu ứng particle
Timeline hiệu ứng
Giá bán

Điều này cho phép mỗi bài hát có cách hoạt động riêng thay vì phải sử dụng chung một cấu hình cho toàn bộ hệ thống.

Hệ thống sở hữu nhạc cá nhân

MusicAura cung cấp hệ thống lưu trữ quyền sở hữu nhạc dành cho từng người chơi.
Người chơi có thể xây dựng thư viện nhạc cá nhân và phát những bài hát mà họ sở hữu.
Quyền sở hữu nhạc có thể đến từ:

Mua trong cửa hàng nhạc
Được quản trị viên cấp
Nhận từ người chơi khác
Được quản lý thông qua hệ thống sở hữu của plugin

Điều này biến âm nhạc thành một dạng vật phẩm sưu tầm trong server, thay vì chỉ đơn giản là một lệnh phát âm thanh.

Cửa hàng nhạc & Kinh tế

MusicAura hỗ trợ bán nhạc thông qua hệ thống kinh tế của máy chủ.
Plugin tích hợp với Vault, cho phép quản trị viên đặt giá riêng cho từng bài hát.
Ví dụ:

Mã:

Ocean Dream
Giá: $75,000

Night Love
Giá: $100,000

Sau khi mua, người chơi sẽ sở hữu bài hát và có thể thêm bài hát đó vĩnh viễn vào thư viện cá nhân.
Cửa hàng cũng có thể kết hợp với DeluxeMenus để xây dựng giao diện GUI tùy chỉnh hoàn toàn theo server.

Tặng nhạc cho người chơi khác

Người chơi có thể chia sẻ những bài hát mà mình sở hữu với người chơi khác.

Mã:

/tangnhac <player> <music-id>

Hệ thống tặng nhạc hỗ trợ các tùy chọn có thể cấu hình như:

Sao chép quyền sở hữu
Chuyển quyền sở hữu
Thuế cố định
Thuế theo phần trăm
Thời gian cooldown khi tặng

Điều này cho phép server biến âm nhạc thành một tính năng mang tính xã hội và sưu tầm.

Hệ thống Particle Aura

MusicAura đồng bộ hiệu ứng particle với quá trình phát nhạc.
Mỗi bài hát có thể có một phong cách hiệu ứng trực quan hoàn toàn khác nhau.
Các kiểu hiệu ứng bao gồm:

Vòng tròn
Sóng
Quỹ đạo
Hào quang
Xoắn ốc
Hiệu ứng mở rộng

Các loại particle có thể sử dụng bao gồm:

Note
Heart
Splash
End Rod
Flame
Soul
Enchant
Firework

Hiệu ứng có thể được cấu hình riêng cho từng bài hát với các thông số như:

Bán kính
Chiều cao
Mật độ
Số điểm
Tốc độ
Loại particle

Timeline hiệu ứng

Một bài hát có thể thay đổi hiệu ứng trực quan theo từng khoảng thời gian trong quá trình phát.
Ví dụ:

Mã:

timeline:
  - start: 0
    end: 60
    effect: heart_orbit

  - start: 60
    end: 200
    effect: note_ring

Điều này cho phép một bài hát có nhiều giai đoạn hiệu ứng khác nhau, thay vì chỉ sử dụng một hiệu ứng duy nhất từ đầu đến cuối.

Phòng nhạc

MusicAura tích hợp hệ thống phòng nhạc dành cho trải nghiệm nghe nhạc nhiều người chơi.
Người chơi có thể sử dụng giao diện phòng nhạc để:

Tạo phòng
Tham gia phòng
Rời phòng
Mời người chơi khác
Quản lý thành viên trong phòng

Hệ thống này cung cấp nền tảng cho trải nghiệm nghe nhạc mang tính xã hội, nơi nhiều người chơi có thể cùng tham gia.

Hệ thống Resource Pack

MusicAura có khả năng tự động xây dựng resource pack cần thiết cho hệ thống âm thanh tùy chỉnh.
Plugin cung cấp hệ thống quản lý và phân phối resource pack để quản trị viên có thể lựa chọn cách cung cấp pack cho người chơi.
Các chế độ triển khai được hỗ trợ:

External URL
HTTP Server tích hợp sẵn
Tắt

Resource pack cũng có thể được tự động gửi cho người chơi khi họ tham gia server.

Tự động nhập nhạc

Việc thêm bài hát mới không yêu cầu quản trị viên phải tự xây dựng các file resource pack.
Đặt file âm thanh vào:

Mã:

plugins/MusicAura/inbox/

Sau đó sử dụng:

Mã:

/nhac zip

MusicAura sẽ nhập các file âm thanh có sẵn và xây dựng lại resource pack cần thiết.
Đối với MP3 hoặc WAV, FFmpeg có thể tự động xử lý âm thanh thành định dạng phù hợp.

Hệ thống yêu cầu nhạc

Người chơi có thể trực tiếp gửi yêu cầu bài hát trên server.

Mã:

/yeucau <song name>

Quản trị viên có thể xem xét và quản lý các yêu cầu được gửi.
Hệ thống hỗ trợ:

Giới hạn số lượng yêu cầu
Cooldown
Quản lý yêu cầu đang chờ
Phê duyệt
Từ chối
Hoàn tất

Điều này giúp đội ngũ quản trị kiểm soát các yêu cầu nhạc từ cộng đồng một cách có tổ chức.

Hỗ trợ GUI

MusicAura cung cấp giao diện GUI cho thư viện nhạc cá nhân và phòng nhạc.
Thư viện nhạc có thể hiển thị:

Nhạc mà người chơi sở hữu
Tên bài hát
Thể loại
Tác giả
Bài hát đang phát
Nút phát
Nút dừng
Phân trang

MusicAura cũng có thể kết hợp với DeluxeMenus để xây dựng giao diện tùy chỉnh hoàn toàn.

Hỗ trợ PlaceholderAPI

MusicAura cung cấp tích hợp PlaceholderAPI, cho phép sử dụng dữ liệu MusicAura trong các plugin khác và các GUI tùy chỉnh.
Một số placeholder:

Mã:

%musicaura_owns_<id>%
%musicaura_price_<id>%
%musicaura_name_<id>%
%musicaura_author_<id>%
%musicaura_category_<id>%
%musicaura_shop_<id>%
%musicaura_ready_<id>%
%musicaura_playing%
%musicaura_is_playing%
%musicaura_owned_count%
%musicaura_balance%
%musicaura_has_economy%
%musicaura_pack_ready%

Nhờ đó MusicAura có thể dễ dàng tích hợp với các menu và hệ thống khác trên server.

Kiểm soát hiệu suất

MusicAura cung cấp nhiều giới hạn có thể cấu hình để phục vụ các server nhiều người chơi.
Quản trị viên có thể kiểm soát:

Số phiên phát nhạc tối đa
Khoảng thời gian cập nhật particle
Số particle tối đa trong mỗi phiên
Giới hạn particle toàn hệ thống
Phạm vi nghe nhạc
Cách thức phát nhạc

Plugin có thể tự động dừng nhạc khi:

Người chơi thoát server
Người chơi chết
Người chơi chuyển sang thế giới bị vô hiệu hóa
Người chơi chủ động dừng nhạc

Những tùy chọn này giúp server cân bằng giữa hiệu ứng trực quan và hiệu suất hệ thống.

Cơ sở dữ liệu

MusicAura sử dụng hệ thống lưu trữ dữ liệu lâu dài cho quyền sở hữu nhạc của người chơi và các dữ liệu liên quan.
SQLite được hỗ trợ làm cơ sở dữ liệu mặc định.
Ngoài ra có thể sử dụng:

MySQL
MariaDB

Hệ thống sao lưu cơ sở dữ liệu tự động có thể cấu hình:

Chu kỳ sao lưu
Số bản sao lưu được giữ lại
Vị trí lưu trữ bản sao lưu

Công cụ quản trị

MusicAura cung cấp đầy đủ các lệnh quản trị để quản lý hệ thống âm nhạc.
Quản trị viên có thể:

Tạo bài hát
Chỉnh sửa bài hát
Xóa bài hát
Nhập file âm thanh
Nhập nhiều file âm thanh
Xây dựng lại resource pack
Thiết lập giá bán
Bật hoặc tắt bán trong cửa hàng
Cấp nhạc cho người chơi
Xóa nhạc của người chơi
Quản lý yêu cầu nhạc
Kiểm tra trạng thái plugin
Tạo bản sao lưu cơ sở dữ liệu
Tải lại cấu hình

Ví dụ:

Mã:

/nhac list
/nhac info <id>
/nhac create <id>
/nhac edit <id>
/nhac delete <id>
/nhac import <file>
/nhac zip
/nhac rebuildpack
/nhac give <player> <id>
/nhac remove <player> <id>
/nhac status
/nhac backup

Tích hợp

MusicAura được thiết kế để hoạt động với các plugin Paper phổ biến.

Tích hợp được hỗ trợ

Vault — Hệ thống kinh tế
PlaceholderAPI — Placeholder và tích hợp GUI bên ngoài
DeluxeMenus — Cửa hàng nhạc và giao diện thư viện tùy chỉnh
FFmpeg — Xử lý âm thanh MP3/WAV

Các tích hợp này được thiết kế để hoạt động tùy chọn ở những nơi có thể, giúp hệ thống cốt lõi vẫn gọn nhẹ.

Ví dụ cấu hình bài hát

Một bài hát có thể được cấu hình như sau:

Mã:

ocean_dream:
  id: ocean_dream
  display_name: "<blue>Ocean Dream"
  author: "Server Music"
  category: Chill

  shop:
    enabled: true
    price: 75000
    currency: money

  playback:
    volume: 1.0
    radius: 30
    loop: true
    category: MUSIC

  particle:
    enabled: true
    preset: ocean_wave
    particle: SPLASH
    radius: 2.0
    height: 1.0
    density: 10
    speed: 0.05

  access:
    type: OWNERSHIP

Cấu trúc này giúp MusicAura có khả năng tùy chỉnh sâu mà không yêu cầu quản trị viên phải chỉnh sửa mã nguồn plugin.

Commands

Lệnh người chơi

Lệnh	Mô tả
`/phatnhac`	Mở thư viện nhạc và phát nhạc đã sở hữu
`/stopnhac`	Dừng bài hát và hiệu ứng hiện tại
`/muanhac <id>`	Mua một bài hát
`/yeucau <song>`	Gửi yêu cầu bài hát
`/tangnhac <player> <id>`	Tặng bài hát đang sở hữu
`/nhacphong`	Mở giao diện phòng nhạc
`/phong`	Mở giao diện phòng nhạc

Lệnh quản trị

Mã:

/nhac list
/nhac info <id>
/nhac create <id>
/nhac edit <id>
/nhac delete <id>
/nhac import <file>
/nhac zip
/nhac rebuildpack
/nhac give <player> <id>
/nhac remove <player> <id>
/nhac requests
/nhac status
/nhac backup
/nhac reload

Permissions

Mã:

musicaura.use
musicaura.play
musicaura.request
musicaura.gift

musicaura.admin
musicaura.admin.music
musicaura.admin.import
musicaura.admin.give
musicaura.admin.requests
musicaura.admin.resourcepack

musicaura.bypass
musicaura.bypass.limit

Yêu cầu

Máy chủ

Paper
Java 25
Phiên bản Minecraft tương ứng với bản build của plugin

Phụ thuộc tùy chọn

Vault
PlaceholderAPI
DeluxeMenus
FFmpeg

Người chơi cần resource pack để có thể nghe được âm thanh tùy chỉnh của MusicAura.

Cài đặt

1. Cài đặt MusicAura

Đặt:

Mã:

MusicAura.jar

vào:

Mã:

plugins/

Sau đó khởi động server một lần.

2. Thêm nhạc

Đặt các file .ogg, .mp3 hoặc .wav vào:

Mã:

plugins/MusicAura/inbox/

3. Nhập nhạc

Sử dụng:

Mã:

/nhac zip

MusicAura sẽ xử lý các file âm thanh và xây dựng resource pack cần thiết.

4. Cấu hình phân phối Resource Pack

Thiết lập URL resource pack trong:

Mã:

resource-pack:
  mode: EXTERNAL_URL
  url: "https://your-domain.com/resourcepack.zip"

5. Tải lại MusicAura

Mã:

/nhac reload

Sau đó hệ thống âm nhạc tùy chỉnh đã sẵn sàng sử dụng.

Tại sao nên sử dụng MusicAura?

MusicAura được xây dựng với mục tiêu biến âm nhạc thành một phần của trải nghiệm Minecraft, thay vì chỉ đơn giản là âm thanh nền.
Thay vì chỉ phát âm thanh cho người chơi, MusicAura kết nối:
Âm nhạc → Sở hữu → Kinh tế → Hiệu ứng trực quan → Phòng nhạc → Resource Pack
Điều này cho phép server xây dựng một hệ sinh thái âm nhạc hoàn chỉnh gắn liền với gameplay và cộng đồng.
MusicAura có thể phù hợp với các loại server như:

SMP
RPG
Survival
Chill
Social
Server tùy chỉnh

Plugin cung cấp nền tảng để biến nhạc tùy chỉnh thành một phần tương tác của trải nghiệm Minecraft.

Tương thích

Nền tảng: Paper
Java: 25
Cơ sở dữ liệu: SQLite / MySQL / MariaDB
Kinh tế: Vault
Placeholder: PlaceholderAPI
GUI: DeluxeMenus
Xử lý âm thanh: FFmpeg

MusicAura hiện đang trong quá trình phát triển. Các tính năng, định dạng cấu hình và API có thể thay đổi giữa các phiên bản phát hành.

AyWu · Lúc 11:18:50

Quá đẳng cấp

	Modding Khoá học lập trình plugin Minecraft miễn phí Teamforest 28/04/2024 Minecraft Plugin Development
	Modding Cần idea làm plugin anhcraft 30/08/2021 Minecraft Plugin Development
	Modding Có ai cần học code plugin không nhỉ? ZzShichiagozZ 05/04/2024 Minecraft Plugin Development
C	Java Block Break Reward \| mới làm con plugin bình dân cho mấy server mine hehe Cao Trọng Thắng 08/10/2022 Minecraft Plugin Development
	Hỏi về plugin thesieutoc GreenDYT 06/06/2022 Minecraft Plugin Development

Java Plugin MusicAura

MusicAura​

Tính năng​

Phát nhạc tùy chỉnh​

Hệ thống sở hữu nhạc cá nhân​

Cửa hàng nhạc & Kinh tế​

Tặng nhạc cho người chơi khác​

Hệ thống Particle Aura​

Timeline hiệu ứng​

Phòng nhạc​

Hệ thống Resource Pack​

Tự động nhập nhạc​

Hệ thống yêu cầu nhạc​

Hỗ trợ GUI​

Hỗ trợ PlaceholderAPI​

Kiểm soát hiệu suất​

Cơ sở dữ liệu​

Công cụ quản trị​

Tích hợp​

Tích hợp được hỗ trợ​

Ví dụ cấu hình bài hát​

Commands​

Lệnh người chơi​

Lệnh quản trị​

Permissions​

Yêu cầu​

Máy chủ​

Phụ thuộc tùy chọn​

Cài đặt​

1. Cài đặt MusicAura​

2. Thêm nhạc​

3. Nhập nhạc​

4. Cấu hình phân phối Resource Pack​

5. Tải lại MusicAura​

Tại sao nên sử dụng MusicAura?​

Tương thích​