GameBanner

An Unreal Engine 5 plugin that provides a circular carousel/banner widget with infinite loop support.

Features

• Infinite loop carousel
• Horizontal and vertical directions
• Touch/mouse drag support with inertia
• Snap animation
• Auto-play with hover pause
• Indicator support (dots or text)
• Full Blueprint support

Requirements

• Unreal Engine 5.0+

Installation

1. Clone or download this repository
2. Copy the GameBanner folder to your project's Plugins directory
3. Restart Unreal Editor
4. Enable the plugin in Edit > Plugins > UI > GameBanner

Usage

1. Create a UserWidget blueprint with parent class UGameBannerWidget
2. Add a Panel widget named GameBannerPanel (CanvasPanel recommended)
3. (Optional) Add Button_Prev and Button_Next buttons
4. (Optional) Add IndicatorPanel container for indicators
5. Set GameBannerData and call InitializeGameBanner in blueprint

Quick Start Blueprint Example

// Create banner data
UGameBannerData* Data = NewObject<UGameBannerData>();

// Add items
FGameBannerItem Item1;
Item1.WidgetClass = MyWidgetClass;  // Your custom widget
Item1.Texture = MyTexture;           // Or use texture directly
Data->AddItem(Item1);

// Initialize
GameBannerWidget->InitializeGameBanner(Data);

API Reference

UGameBannerWidget

Property	Type	Description
Direction	EGameBannerDirection	Horizontal or Vertical
ItemSpacing	float	Spacing between items
ItemFixedSize	FVector2D	Size of each item
bInfiniteLoop	bool	Enable infinite scrolling
bAutoCenter	bool	Auto-center items
TransitionDuration	float	Animation duration
bAutoPlayEnabled	bool	Enable auto-play
AutoPlayInterval	float	Time between slides

Main Functions

• InitializeGameBanner(Data) - Initialize with data
• GoToPage(Index) - Jump to specific page
• PreviousPage() / NextPage() - Navigation
• StartAutoPlay() / StopAutoPlay() - Control auto-play
• GetCurrentIndex() - Get current page index

Events

• OnIndexChanged - Fired when page changes

License

MIT License - see LICENSE