Mirrors - fe-art/Toolscreen GitHub Wiki

What Are Mirrors?

Mirrors capture a section of the screen, apply transformations (recolor, reposition, add borders), and display the result elsewhere. They're useful for highlighting specific information like pie chart values, timers, or entity counters.

Creating a Basic Mirror (Pie Chart Example)

This example creates a mirror that shows the block entities mob spawner value on the pie chart.

  1. Go to Advanced > Mirrors.
  2. Click Add New Mirror and give it a name (e.g., "Mob Spawner").
  3. Go to Advanced > Modes > Full Screen > Mirrors and add the new mirror.
  4. Go back to Advanced > Mirrors and select your mirror.
  5. Enable Raw Output so you can see what the mirror is capturing while you configure it.

Configuring the Capture Zone

  1. Scroll down to Input/Capture Zones.
  2. Change the capture zone to be relative to Pie Chart Left (the left column of numbers on the F3 pie chart).
  3. Temporarily increase the output Scale so it's easier to see.
  4. Adjust the Capture Width and Capture Height to cover exactly one row of numbers.

The mob spawner and chest can switch places in the list order, but Unspecified is usually at the top. Adjust the capture zone to target the second row.

To capture additional rows, click Add under capture zones and set the Y offset to be 8 pixels more than the previous zone. This captures the row below.

Capture zone on pie chart

Once the capture zone is set, scroll up to Target Color and type in the exact RGB value of the color you want to isolate (use an external color picker to find it). Disable Raw Output — the matched content will now appear in black. Change the Output Color to your desired color.

Positioning the Mirror Output

  1. Go to Output Position and set it to be relative to Pie Chart Left.
  2. Use negative X and Y offsets to move the output up onto the pie chart itself.
  3. Customize the Border Thickness if desired. Note that adding a border changes the output position slightly.
  4. For values that change (like counters), use the Dynamic Border setting. Use Static Border only for things that never change shape (like the pie chart itself).

Mirror output on pie chart

Creating an Advanced Mirror (Rainbow Timer)

This example changes the in-game timer from a static color to an animated rainbow.

  1. Go to Advanced > Mirrors > Add New Mirror. Give it a name (e.g., "Rainbow Timer").
  2. Go to Advanced > Modes > Full Screen > Mirrors and add it.
  3. Go back to the mirror config.
  4. Set the FPS to Real Time so the timer updates every frame without delay.
  5. Enable Raw Output temporarily.

Capturing the Timer and Adding a Rainbow Gradient

  1. Go to Input Position and set it relative to Top Right Screen.
  2. Temporarily increase the output Scale.
  3. Adjust the Capture Width and Capture Height to cover the full timer. Test on a practice map with a long play time to make sure it works with large numbers.
  4. Add a Target Color with the exact RGB value of your timer text (use an external color picker to find it).
  5. Disable Raw Output. The timer should now appear in black.
  6. Enable Gradient Output.
  7. Increase the Border Thickness.
  8. Add color stops to the gradient: red, orange, yellow, green, blue, purple.
  9. Remove any default colors (like white) that you don't want.
  10. Adjust the percentage sliders so colors are evenly spread. For 6 colors, space them roughly 16% apart (0, 16, 33, 50, 66, 83).
  11. Add a Slide animation. The rainbow colors will scroll across the timer.
  12. Adjust the Speed and Angle of the animation.

Rainbow gradient color stops

Aligning the Rainbow Timer

  1. Set the Output Position to relative to Top Right Screen.
  2. Decrease the Scale back to 100%.
  3. Adjust the X and Y offsets until the rainbow output lines up perfectly over the original timer. The dynamic border may shift the position, so fine-tune the offsets.

If you see pixels from the original timer bleeding through (e.g., tiny bits of green), scroll up and increase the Color Sensitivity until they disappear.

Note: If you want to use a mirror in a different mode (e.g., Thin), you need to create a separate mirror for that mode because the source content is at a different size and position.