public

Rpg Maker Developers Group

Simple enough for a child, powerful enough for a developer

2 Followers

XPDisplay a number on the map

BMM Archive · July 16, 2026

Preserved forum archive. This topic stores the original first post and locally mirrored RPG Maker Web attachments when available. It is posted by the BMMPlay archive account, not by the original creator.

Original Source

  • Original title: Display a number on the map
  • Original author: astrobunny
  • Original date: May 17, 2020
  • Source thread: https://forums.rpgmakerweb.com/threads/display-a-number-on-the-map.121687/
  • Source forum path: Game Development Engines > Ruby Game System (RGSS) Scripts > RGSS Scripts (RMXP)

Summary

Map Number Displayer v1.0 by astrobunny Introduction This simple script places a number on your map that you can manipulate by changing a switch and a variable!

Archived First Post

Map Number Displayer v1.0

by astrobunny


Introduction

This simple script places a number on your map that you can manipulate by changing a switch and a variable!

Features

- Easy to use and manipulate with events!
- Fast, does not kill framerate
- Customize your text image

How to use Video Tutorial



Screenshots

screenshot.PNG


Demo

Download the demo here!

https://astrobunny.net/labs/downloads/playercash.zip

Script

Code:
#########################################################
### FIRST PART OF THE CODE
#########################################################


    @nums = Sprite.new(@viewport3)
    @nums.z = 9999
    @nums.x = 30
    @nums.y = 30

    @nums_bitmap = RPG::Cache.picture('nums.png')
    @nums_number_width = @nums_bitmap.width / 10
    @nums_max_digits = 6
    @nums_display = Bitmap.new(@nums_number_width * @nums_max_digits, @nums_bitmap.height)
    @nums.bitmap = @nums_display
    @nums_variable ||= 1
    @nums_temp_variable ||= 2
    @nums_visible_switch ||= 1
    @nums_visible = false



#########################################################
### SECOND PART OF THE CODE
#########################################################


  def update_number!
    return if !$game_switches[@nums_visible_switch] && !@nums_visible

    @nums_display.fill_rect(0, 0, @nums_display.width, @nums_display.height, Color.new(0, 0, 0, 0))
    @nums_visible = false
    return if !$game_switches[@nums_visible_switch]

    if $game_variables[@nums_variable].to_i < 0
      $game_variables[@nums_variable] = 0
    end

    displayed = $game_variables[@nums_temp_variable].to_i
    actual = $game_variables[@nums_variable].to_i
    if actual > displayed
      $game_variables[@nums_temp_variable] += 1
    elsif actual < displayed
      $game_variables[@nums_temp_variable] -= 1
    else
      return unless $game_switches[@nums_visible_switch]
    end

    number = displayed.to_s
    number.split('').each_with_index do |chr, idx|
      digit = chr.to_i
      src_rect = Rect.new(@nums_number_width * digit, 0, @nums_number_width, @nums_display.height)
      @nums_display.blt(idx * @nums_number_width, 0, @nums_bitmap, src_rect)
    end
    @nums_visible = true
  end


#########################################################
### THIRD PART OF THE CODE
#########################################################

    update_number!

#########################################################
### THAT'S ALL FOLKS!
#########################################################

FAQ

Q
: The demo won't open, how to open it?

A: You need RPG Maker XP

Q: Who should i credit?

A: Me, astrobunny.

Q: Can I use my own number image?

A: Yes! You have to make it so all the numbers occupy the same sized rectangle in the image. Basically, divide your image into 10 equally spaced parts, and place each of your numbers in each part. You should also make your background transparent in your PNG. You must also name it nums.png

Have a look at these images I made for you that can also be used! Use the following images as a reference. Feel free to use them or modify them to your liking!

nums.png

nums_2.png

nums_3.png

Q: How do I change where the number is positioned?

A: Look at the [first part of the code] and then find @nums.x = 30 and @nums.y = 30, change these numbers. @nums.x is the number of pixels away from the left of the window and @nums.y is the number of pixels down from the top of the window of the leftmost number.

Q: How many digits maximum?

A: Look at the [first part of the code] and find @nums_max_digits = 6. You can change this number to any number of digits you wish.

Author's Notes

Have fun with the script, and I will try to answer any replies to this thread or to the youtube video if I have time. Please send me your love/post credits if you do use it!

Terms of Usage

Free for commercial and non-commercial use. Edits allowed. Please do not re-post this, just link back to the youtube video or this forum!

Features Mentioned

  • Easy to use and manipulate with events!
  • Fast, does not kill framerate
  • Customize your text image
  • How to use Video Tutorial

Downloads / Referenced Files

Log in to download

Log in, then follow the RPG Maker Developers Group to see these download links.

Log in to download

License / Terms Note

Q: Who should i credit? A: Me, astrobunny. Q: Can I use my own number image? A: Yes! You have to make it so all the numbers occupy the same sized rectangle in the image. Basically, divide your image into 10 equally spaced parts, and place each of your numbers in each part. You should also make your background transparent in your PNG. You must also name it nums.png

Creator Claims / Removal

If you are the original creator and want this listing reassigned, edited, or removed, join BMMPlay and contact the moderators with proof that matches the original RPG Maker Web profile, linked GitHub, itch.io page, or another public creator identity.

#rgss#script-archive

Replies (0)

No replies yet.

0 replies 1 view

Log in to reply.

User Avatar