Frequently Asked Questions

General Questions

What is BlocKIT?

BlocKIT is a complete Unity asset for creating Block Blast style puzzle games. It includes all core mechanics, UI, animations, and systems needed to launch a game.

Do I need programming knowledge?

Basic usage: No! Most customization can be done through Unity Inspector.

Advanced features: Some C# knowledge helps for deeper modifications.

What Unity version do I need?

Minimum: Unity 2021.3 LTS

Recommended: Unity 2022.3 LTS or newer

What dependencies are required?

Required: - DOTween (free from Asset Store)

Optional: - TextMeshPro (for better text) - Ad SDK of your choice (AdMob, Unity Ads, etc.)

Setup Questions

Game won't start - what to do?

✅ Check DOTween is installed
✅ Check NewManager exists in scene
✅ Check all references in NewManager are set
✅ Look for errors in Console

Shapes not dragging - what's wrong?

✅ Canvas must have GraphicRaycaster
✅ EventSystem must exist in scene
✅ NewDraggableShape needs EventTrigger component
✅ Check Camera is set in Canvas

No animations playing - why?

✅ Install DOTween from Asset Store
✅ Restart Unity after DOTween installation
✅ Check using DG.Tweening; in scripts
✅ Verify DOTween setup ran successfully

Gameplay Questions

How do I change board size?

Select NewMatrix in Hierarchy
Change Rows and Columns in Inspector
⚠️ Important: Must adjust Canvas layout to fit!

Example for 10×10:

NewMatrix:
├── Rows: 10
└── Columns: 10

Also adjust:
├── Canvas → GameBoard → Scale
└── Canvas → GameBoard → Position

Can I add more than 3 shapes per turn?

Yes! In NewBlockBlastLogic.cs:

// Change this line:
private const int SHAPES_PER_TURN = 3;

// To whatever you want:
private const int SHAPES_PER_TURN = 5;

⚠️ UI Warning: Need more space in ShapesPanel!

How do I make the game easier/harder?

Easy: Go to NewBrain Inspector:

Easy Threshold: 0.5      (was 0.3)
Combo Multipliers: [1.0, 2.0, 3.0, 5.0, 10.0]
MAX_MISSING_CELLS: 12    (in code)

Hard:

Easy Threshold: 0.2
Combo Multipliers: [1.0, 1.1, 1.2, 1.3, 1.4]
MAX_MISSING_CELLS: 4

Can I disable the AI difficulty system?

Yes! In NewBrain.cs:

void Start()
{
    adaptationEnabled = false;
    SetDifficulty(0.5f);  // Lock to Normal
}

Or just give random shapes:

// In NewBlockBlastLogic.PickTurnSet():
return pool.OrderBy(x => Random.value).Take(3).ToArray();

Customization Questions

How do I change colors?

Board:

NewMatrix Inspector:
├── Cell Color Empty
├── Cell Color Filled
└── Cell Color Highlight

Shapes:

Each ShapeData asset:
└── Color property

How do I add custom shapes?

Assets/BlocKIT/Data/ → Right Click
Create → BlocKIT → Shape Data
Design shape in Inspector (click cells)
Add to NewManager → Shape Data Assets list

Can I add rotation?

Not built-in, but you can add:

// In NewDraggableShape.cs
void Update()
{
    if (Input.GetKeyDown(KeyCode.R) && isDragging)
    {
        RotateShapeData90Degrees();
        UpdateVisual();
    }
}

How do I change animation speed?

Find these constants in scripts:

// NewDraggableShape.cs
DRAG_SCALE_DURATION = 0.2f

// NewCleanLine.cs
CLEAR_DURATION = 0.5f

// PopupAnimator.cs
POPUP_DURATION = 0.3f

Smaller = faster, larger = slower.

Performance Questions

Game is laggy on mobile - how to optimize?

Reduce board size: 8×8 → 6×6
Disable particles: Set particlesEnabled = false
Simplify animations: Increase duration constants
Lower quality: Edit → Project Settings → Quality
Optimize sprites: Use sprite atlas, compress textures

Too many objects in scene?

BlocKIT uses object pooling for: - Shapes - Cells - Floating score texts

Should not be an issue unless you modified pooling!

Memory usage too high?

✅ Compress audio files (use OGG)
✅ Use smaller textures
✅ Atlas sprites together
✅ Limit simultaneous animations

Monetization Questions

How do I add ads?

See Ads System documentation.

Quick version:

// 1. Create provider
var provider = new AdMobProvider();

// 2. Set in AdsManager
AdsManager.Instance.SetProvider(provider);

// 3. Show ads
AdsManager.Instance.ShowInterstitial();

When should I show ads?

Good times: - ✅ After game over - ✅ Every 3-5 games - ✅ When returning to menu - ✅ Between sessions

Bad times: - ❌ During gameplay - ❌ Every single game - ❌ Before player has fun

How do I add IAP (in-app purchases)?

Install Unity IAP package
Create purchasable items:
Remove ads
Undo packs
Power-ups
Themes

Implement:

public void OnPurchaseSuccess(string productId)
{
    if (productId == "remove_ads")
    {
        PlayerPrefs.SetInt("NoAds", 1);
        AdsManager.Instance.DisableAds();
    }
}

Technical Questions

What is the performance like?

Excellent! Runs smoothly on: - ✅ Low-end Android phones (2GB RAM) - ✅ Old iPhones (iPhone 6s+) - ✅ Web browsers - ✅ Desktop

Target: 60 FPS on all platforms.

Can I use it for commercial projects?

Check your license! Most assets allow commercial use. BlocKIT is designed for commercial release.

Does it support multiplayer?

Not built-in, but you can add: - Leaderboards (easy with PlayFab, GameCenter) - Turn-based multiplayer (moderate difficulty) - Real-time battles (advanced)

Can I port to web/mobile/console?

Web: Yes! Works with WebGL.

Mobile: Yes! Optimized for iOS/Android.

Console: Should work, but not tested.

Is source code included?

Yes! All C# scripts are readable and modifiable.

Error Messages

"DOTween not found"

Solution: Install DOTween from Asset Store, restart Unity.

"NullReferenceException: NewManager.Instance"

Solution: NewManager missing from scene or destroyed. Check scene setup.

"Cannot place shape"

Solution: This is normal - shape doesn't fit. It's gameplay, not a bug!

"Ads not showing"

Solutions: 1. ✅ Check provider is set: AdsManager.Instance.SetProvider() 2. ✅ Verify ad IDs are correct 3. ✅ Check network connection 4. ✅ Look for SDK errors in Console

Game Design Questions

What makes a good score?

Balance: - Base points: Small (3-5 per shape) - Line clear: Medium (100-200) - Combo: Large multiplier (1.5x - 3.0x)

Psychology: - Players love big combo numbers! - Frequent small wins keep engagement - Rare huge scores create "wow" moments

How long should games be?

Casual: 2-5 minutes average

Mid-core: 5-10 minutes

Hardcore: 10-30 minutes

Adjust by: - Board size - Shape difficulty - Combo frequency

Should I use power-ups?

Pros: - More monetization options - Strategic depth - Player retention

Cons: - More development work - Can unbalance game - UI complexity

Recommendation: Start without, add if needed.

Still Have Questions?

Check Documentation

Debug Tools

Enable debug mode:

// In NewManager
public bool debugMode = true;

Shows: - Current difficulty - Board state - Valid placements - Performance stats

Community Support

Read all documentation first
Check Console for errors
Enable debug mode
Search for similar issues

Pro Tip

95% of issues are fixed by: reinstalling DOTween, checking references in Inspector, or reading error messages carefully!