RPG Maker XP - Script Library

A collection of enhanced and custom RPG Maker XP scripts.
Improved gameplay mechanics, visual enhancements, and extended functionality.

This collection provides enhanced RPG Maker XP scripts that improve existing default scripts with better gameplay mechanics and additional functionality. Originally developed for personal projects, these scripts are now shared with the community as open source resources for other game developers.

Each script maintains full compatibility with the standard RPG Maker XP framework while adding enhanced gameplay features and mechanics. Whether you're developing a classic RPG or experimental project, these scripts provide improved player experience without requiring additional resources or external dependencies.

Script Overview

Enhanced Player Movement: Jump system with cooldown mechanics and collision detection
Real-Time HUD Display: Overlay showing party member HP/SP bars during map exploration
BGM Player Menu: Interactive music player with volume/pitch controls and file browser
Typewriter Message System: Character-by-character text display with sound effects
Enhanced Menu Windows: Icon integration for Gold, Steps, and PlayTime displays
Visual Timer System: Enhanced timer with warning effects, color changes, and sound alerts
Grid Save System: 2x2 save file layout with confirmation dialogs and preview
Horizontal Title Menu: Side-by-side menu options with individual window styling
Transparent Menu System: Menu scenes with background visibility and improved window layouts

Key Features

Drop-in Compatibility: Easy integration without breaking existing functionality
No External Dependencies: Uses only standard RPG Maker XP resources
Fully Customizable: Easy modification of parameters and visual elements
Performance Optimized: Efficient code that doesn't impact game performance

Compatibility

RPG Maker: RPG Maker XP
Ruby Version: 2.0+ (built-in with RPG Maker XP)
Platform: Windows
Dependencies: None (uses standard RPG Maker XP framework only)

Getting Started

Requirements

RPG Maker XP (any version)
Basic understanding of the Script Editor
No additional files or resources required

Quick Setup

Open your RPG Maker XP project
Press F11 to access the Script Editor
Find the script you want to enhance (e.g., "Game_Player" for jump system)
Replace the existing script content with the enhanced version
Save your project (Ctrl+S) and test the new functionality

Adding Scripts to Your Project

Open Script Editor
- Launch RPG Maker XP and open your project
- Press F11 to open the Script Editor
Locate Target Script
- Find the script you want to enhance in the script list (left panel)
- Click to select it (e.g., "Game_Player" for jump system)
Replace Script Content
- Select all existing content (Ctrl+A)
- Delete the selected content
- Copy and paste the enhanced script from this repository
Save Changes
- Press Ctrl+S to save your changes
- Close the Script Editor
- Test your game to verify functionality

Important Notes: Always backup your project before adding new scripts:

Create a complete copy of your project folder
Export existing scripts if you've made custom modifications
Test scripts on a backup project first

Verifying Setup

Run your game in test mode (F12)
Test the new functionality (e.g., press A/Shift for jump system)
Verify existing features still work correctly
Check that no script errors appear in the console

Common Issues

Script Not Working:

Verify the script was pasted correctly and completely
Check that you're using the correct input (A/Shift for jump system)
Ensure no syntax errors were introduced during copying

Sound Effects Not Playing:

Confirm sound files exist in your project's Audio/SE folder
Check the filename matches exactly in the script
Verify your project's audio settings

Conflicts with Other Scripts:

Test with a fresh project to identify conflicts
Check for other custom scripts modifying the same classes
Some scripts may need to be placed in specific order

Player Jump System

Enhanced player movement system that adds jump functionality to the standard movement controls. The player can now leap over obstacles and traverse terrain more dynamically using the A button (Shift key by default).

Core Features

Jump Mechanics: Player jumps 2 tiles in current facing direction
Collision Detection: Prevents jumping into walls or impassable terrain
Cooldown System: 30-frame cooldown prevents spam jumping
Sound Integration: Plays jump sound effect during jumps
Direction-Based: Jump direction follows player's current orientation

Key Implementation

JUMP_DISTANCE = 2              # How many tiles to jump
JUMP_COOLDOWN_FRAMES = 30      # Frames between jumps

def try_jump
  return if @jump_cooldown && @jump_cooldown > 0
  dx = (self.direction == 6 ? 1 : self.direction == 4 ? -1 : 0) * JUMP_DISTANCE
  dy = (self.direction == 2 ? 1 : self.direction == 8 ? -1 : 0) * JUMP_DISTANCE
  if passable?(@x + dx, @y + dy, 0)
    jump(dx, dy)
    Audio.se_play("Audio/SE/016-Jump02", 80, 100)
    @jump_cooldown = JUMP_COOLDOWN_FRAMES
  end
end

Customization

Adjust jump distance:

JUMP_DISTANCE = 3    # Jump 3 tiles instead of 2

Change jump cooldown:

JUMP_COOLDOWN_FRAMES = 60    # 1 second cooldown

Custom jump sound:

Audio.se_play("Audio/SE/YourJumpSound", 100, 120)

Player HUD System

Real-time overlay HUD showing party member HP/SP bars during map exploration. Automatically manages visibility across different scenes and supports up to 4 party members.

Core Features

Live HP/SP Display: Real-time health monitoring during gameplay
Gradient Health Bars: Visual bars with smooth color effects
Auto Scene Management: Shows/hides appropriately in different scenes
Multi-Party Support: Displays up to 4 party members simultaneously

Key Customization

# HUD Position
y_position = screen_height - 92    # Distance from bottom
box_width = screen_width / 4       # Width per member

# Transparency
self.opacity = 200         # Window background
self.back_opacity = 160    # Content background

# Health Bar Colors
Color.new(220, 60, 60)     # HP (Red)
Color.new(60, 60, 220)     # SP (Blue)

BGM Player Menu

Interactive music browser with real-time volume/pitch controls and multi-format support. Integrates with the title screen menu for easy access.

Core Features

Music Library Browser: Navigate through available BGM files
Real-Time Controls: Adjust volume (0-100%) and pitch (50-150%) during playback
Multi-Format Support: Auto-detection for OGG, MP3, WAV, and MIDI files
Title Screen Integration: Add to main menu for easy access

Key Customization

# Add BGM files to the list
def load_bgm_list
  @bgm_list = [
    RPG::AudioFile.new("001-Battle01", 100, 100),
    RPG::AudioFile.new("MyCustomSong", 100, 100),  # Add custom files
  ]
end

# Adjust control sensitivity
bgm.volume = [bgm.volume + 5, 100].min  # ±5% increments
bgm.pitch = [bgm.pitch + 5, 150].min    # ±5% increments

Title Screen Integration

# In Scene_Title update method
when 2  # BGM Player option
  $scene = Scene_Audio_BGM.new

Typewriter Message System

Enhanced message window that displays text character-by-character with sound effects. Players can skip the animation by pressing the confirm button to instantly display the complete message.

Core Features

Character-by-Character Display: Text appears one letter at a time
Sound Feedback: Plays cursor sound for each character (except spaces)
Skip Function: Press C/Enter to instantly show full message
Full Compatibility: Maintains all original message window functionality

Key Implementation

def update
  if @typewriter_index < @typewriter_all_text.length
    @typewriter_wait -= 1
    if @typewriter_wait <= 0
      char = @typewriter_all_text[@typewriter_index, 1]
      @typewriter_text += char
      if char != " " and char != "\n"
        $game_system.se_play($data_system.cursor_se)
      end
      @typewriter_index += 1
      @typewriter_wait = 1  # Speed control
    end
  end
end

Customization

Adjust typing speed:

@typewriter_wait = 2    # Slower typing
@typewriter_wait = 0    # Instant typing

Enhanced Menu Windows

Improved versions of the standard Gold, Steps, and PlayTime windows with icon integration. These drop-in replacements add visual icons while maintaining all original functionality.

Features

Window_Gold: Treasure chest icon (032-Item01)
Window_Steps: Boot icon (020-Accessory05)
Window_PlayTime: Clock icon (016-Accessory01) with hours:minutes format

Icon Customization

Change icons by modifying the icon filename:

# In Window_Gold
icon = RPG::Cache.icon("032-Item01")    # Change filename here

# In Window_Steps  
icon = RPG::Cache.icon("020-Accessory05")

# In Window_PlayTime
icon = RPG::Cache.icon("016-Accessory01")

Icon Positioning

Adjust icon placement:

self.contents.blt(4, 36, icon, Rect.new(0, 0, 24, 24))
#                 x  y   coordinates

Visual Timer System

Enhanced timer display with visual warning effects, color changes, and sound alerts. Features screen shake and opacity pulsing when time is running low.

Core Features

Visual Warning System: Color changes and pulsing effects as time decreases
Screen Shake: Timer window shakes when under 5 seconds remain
Sound Effects: Tick sounds every second, warning sound at timer end
Dynamic Colors: White → Yellow → Pulsing Red based on remaining time

Key Implementation

def redraw_timer
  if @warning_mode
    pulse_alpha = 128 + (Math.sin(@pulse_timer * 0.3) * 127).to_i
    time_color = Color.new(255, pulse_alpha / 2, pulse_alpha / 2, 255)
  elsif total_seconds <= 30
    time_color = Color.new(255, 255, 100, 255)  # Yellow warning
  else
    time_color = Color.new(255, 255, 255, 255)  # Normal white
  end
end

Customization

# Warning thresholds
if current_sec <= 10          # Red pulsing warning
elsif total_seconds <= 30     # Yellow warning

# Shake effect timing
if $game_system.timer / Graphics.frame_rate <= 5  # Screen shake

Grid Save System

Redesigned save/load interface with 2x2 grid layout, file preview, and confirmation system. Features transparent windows over title background.

Core Features

2x2 Grid Layout: Four save slots arranged in organized grid
File Preview: Selected save file displayed in center with full details
Confirmation System: Separate confirmation dialog before save/load action
Character Display: Shows party member sprites in save file preview

Key Implementation

# Grid positioning
margin = 20
window_width = (640 - margin * 3) / 2
window_height = (480 - 64 - margin * 3) / 2

for i in 0..3
  x_pos = (i % 2) * (window_width + margin) + margin
  y_pos = (i / 2) * (window_height + margin) + 64 + margin
  @savefile_windows.push(Window_SaveFile.new(i, make_filename(i), x_pos, y_pos, window_width, window_height))
end

Navigation Controls

Arrow Keys: Navigate between save slots in 2x2 grid
C Button: Enter confirmation mode
B Button: Cancel/Return to previous menu

Horizontal Title Menu

Redesigned title screen with side-by-side menu options displayed in individual windows. Features horizontal navigation and visual highlighting.

Core Features

Individual Windows: Each menu option in separate styled window
Horizontal Layout: Side-by-side arrangement instead of vertical list
Visual Highlighting: Selected option changes color dynamically
Centered Design: Automatically centers menu based on number of options

Key Implementation

@menu_labels = ["New Game", "Continue", "Shutdown"]
menu_w = 160
menu_h = 56
menu_margin = 24
total_w = @menu_labels.size * menu_w + (@menu_labels.size - 1) * menu_margin
start_x = 320 - total_w / 2  # Center the menu

# Create individual windows
for i in 0...@menu_labels.size
  win = Window_Base.new(start_x + i * (menu_w + menu_margin), y, menu_w, menu_h)
  win.opacity = 200
  win.back_opacity = 160
end

Customization

# Window dimensions
menu_w = 160          # Width of each menu window
menu_h = 56           # Height of each menu window
menu_margin = 24      # Space between windows
y = 380               # Vertical position

# Add new menu options
@menu_labels = ["New Game", "Continue", "BGM Player", "Shutdown"]

Transparent Menu System

Complete overhaul of menu scenes to display the game map in the background with transparent window effects. Provides better visual continuity and organized information display across all menu screens.

Core Features

Background Visibility: Game map remains visible behind all menu screens
Transparent Windows: All menu windows use opacity settings for see-through effect
Individual Character Windows: Each party member has separate status window in main menu
Organized Layout: Status screen split into focused windows for better readability
Skill Information Panel: Additional stat windows showing Cost, Accuracy, Power, and Variance

Key Implementation

# Standard transparency settings for all menu windows
window.opacity = 210        # Window background (0-255)
window.back_opacity = 170   # Window content background (0-255)

# Background map sprite
@map_sprite = Spriteset_Map.new
@map_sprite.update

Enhanced Menu Layouts

Scene_Menu: Individual character windows instead of single party window

@character_windows = []
for i in 0...4
  x = 160
  y = i * 120
  @character_windows[i] = Window_CharacterStatus.new(x, y, i)
end

Scene_Skill: Four stat windows at bottom displaying detailed skill information

@stat_windows = []
@stat_windows[0] = Window_SkillStat.new(0, 400, 160, "Cost")
@stat_windows[1] = Window_SkillStat.new(160, 400, 160, "Accuracy") 
@stat_windows[2] = Window_SkillStat.new(320, 400, 160, "Power")
@stat_windows[3] = Window_SkillStat.new(480, 400, 160, "Variance")

Scene_Status: Information split into separate organized windows

Window_StatusBasic: Character graphic, name, class, level, experience
Window_StatusVital: HP and SP with current/max values
Window_StatusParameters: All character stats (ATK, DEF, etc.)
Window_StatusEquipment: Currently equipped weapons and armor

Transparency Customization

# Adjust transparency levels
window.opacity = 255        # Completely opaque
window.opacity = 128        # Semi-transparent  
window.opacity = 0          # Completely transparent

window.back_opacity = 200   # Content background transparency

License

This project is licensed under the MIT License - see the LICENSE file for details.

Screenshots

The following screenshots demonstrate the core functionality of each script, including the enhanced player movement, real-time HUD display, interactive BGM player, and improved menu systems with visual enhancements.

Script - BGM Player	Script - HUD System	Script - Enhanced Menus

Script - Grid Save System	Script - Skill Information	Script - Visual Timer

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
Custom		Custom
Game		Game
Scene		Scene
Sprite		Sprite
Window		Window
img		img
LICENSE		LICENSE
README.md		README.md

License

BerndHagen/RPG-Maker-XP-Script-Library

Folders and files

Latest commit

History

Repository files navigation

RPG Maker XP - Script Library

Script Overview

Key Features

Compatibility

Table of Contents

Getting Started

Requirements

Quick Setup

Adding Scripts to Your Project

Verifying Setup

Common Issues

Player Jump System

Core Features

Key Implementation

Customization

Player HUD System

Core Features

Key Customization

BGM Player Menu

Core Features

Key Customization

Title Screen Integration

Typewriter Message System

Core Features

Key Implementation

Customization

Enhanced Menu Windows

Features

Icon Customization

Icon Positioning

Visual Timer System

Core Features

Key Implementation

Customization

Grid Save System

Core Features

Key Implementation

Navigation Controls

Horizontal Title Menu

Core Features

Key Implementation

Customization

Transparent Menu System

Core Features

Key Implementation

Enhanced Menu Layouts

Transparency Customization

License

Screenshots

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Languages

Packages