Skip to content

LederyCore/FrameChecker

Repository files navigation

TitleImage

Frame Checker

유니티 인게임 디버깅을 위한 프레임 체커 컴포넌트


Unity Download Link License MIT

AboutInstallationFeaturesEditor SupportSupport

About

Frame Checker는 유니티 게임 실행 중 프레임 속도를 정밀하게 모니터링하기 위한 도구입니다. 단순히 현재 FPS를 보여주는 것을 넘어, 씬 로드 시의 병목을 제외하는 Warmup 기능과 극단적인 수치를 제외하는 Outlier Filtering을 통해 실제 사용자 경험에 가까운 통계를 제공합니다.

런타임 UI와 에디터 메뉴를 모두 지원합니다.

Image Image

Installation

이 git URL을 Unity Package Manager -> Install package from git URL 에 붙여 넣습니다.

https://github.com/LederyCore/FrameChecker.git

Features

Feature Description
Real-time Monitoring 현재 프레임(ms) 및 FPS를 실시간으로 추적합니다.
Warmup Period 씬 로드 직후 발생하는 일시적인 프레임 드랍이 통계에 영향을 주지 않도록 대기 시간을 설정합니다.
Statistical Analysis 누적된 샘플을 바탕으로 Average, Min, Max FPS를 계산합니다.
Outlier Filtering 설정된 비율만큼 상하위 극단값을 제거하여 안정적인 평균치를 산출합니다.
Editor Integration 인스펙터 우클릭 메뉴 및 상단 Tools 메뉴를 통해 모든 측정기를 일괄 리셋할 수 있습니다.

Settings

Frame Checker는 인스펙터를 통해 프로젝트 환경에 맞게 세부 조정이 가능합니다.

1. General Settings

  • Show UI: 화면 좌측 상단에 통계 UI를 표시할지 여부를 결정합니다.
  • Text Color: 출력되는 텍스트의 색상을 변경합니다.
  • Font Size: UI의 가독성을 위해 글꼴 크기를 조절합니다.

2. Profiling Settings

  • Warmup Time: 측정 시작 전 대기 시간입니다. (기본값: 3초)
  • Sample Count: 평균 FPS 계산에 사용할 프레임 샘플의 개수입니다. 값이 클수록 변화가 완만해집니다.
  • Outlier Threshold: 0.05 설정 시 상위 5%, 하위 5%의 데이터를 통계 계산에서 제외하여 수치의 신뢰도를 높입니다.

Editor Support

개발 편의성을 위해 다양한 에디터 기능을 제공합니다.

  • Runtime Reset: UI 상의 Reset Stats 버튼을 눌러 즉시 통계를 초기화할 수 있습니다.
  • Context Menu: 인스펙터의 FrameChecker 컴포넌트를 우클릭하여 Reset Statistics를 실행할 수 있습니다.
  • Global Reset: 상단 메뉴 Tools > LederyCore > Reset All Frame Checkers를 통해 씬에 존재하는 모든 측정기를 한 번에 리셋하고 Warmup을 재시작합니다.

Support

이 유틸리티는 확장 가능한 구조로 설계되었습니다. 버그 리포트나 기능 제안은 언제든지 환영합니다.

Copyright (c) 2026 Lee Eun Su

About

A Unity package to monitor and analyze frame rates during gameplay.

Topics

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.meta

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages